Understanding Assembly Language 


Dennis Yurichev 


Understanding Assembly Language 


(Reverse Engineering for Beginners) 


Why two titles? Read here: on page xvi. 


Dennis Yurichev 
my emails 


OOO 
©2013-2022, Dennis Yurichev. 


This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 
International (CC BY-SA 4.0) license. To view a copy of this license, visit 
https://creativecommons.org/licenses/by-sa/4.0/. 


Text version (October 23, 2023). 


The latest version (and Russian edition) of this text is accessible at 
https://beginners.re/. 


Call for translators! 


You may want to help me with translating this work into languages other than English 
and Russian. Just send me any piece of translated text (no matter how short) and 
l'Il put it into my LaTeX source code. 


Do not ask, if you should translate. Just do something. | stopped responding “what 
should | do" emails. 


Also, read here. 
The language statistics is available right here: https://beginners.re/. 


Speed isn't important, because this is an open-source project, after all. Your name 
will be mentioned as a project contributor. Korean, Chinese, and Persian languages 
are reserved by publishers. English and Russian versions | do by myself, but my 
English is still that horrible, so I’m very grateful for any notes about grammar, etc. 
Even my Russian is flawed, so I'm grateful for notes about Russian text as well! 


So do not hesitate to contact me: my emails. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Abridged contents 


1 Code Patterns 

2 Important fundamentals 

3 Slightly more advanced examples 

4 Java 

5 Finding important/interesting stuff in the code 
6 OS-specific 

7 Tools 

8 Case studies 

9 Examples of reversing proprietary file formats 
10 Dynamic binary instrumentation 

11 Other things 

12 Books/blogs worth reading 


13 Communities 


Afterword 1286 


Appendix 1288 

Acronyms Used 1325 

Glossary 1332 

Index 1335 
Contents 

1 Code Patterns 1 

1,1 The method s.m: 9 Rok Ee bbe eee d o oDdede de LP 3 1 

lx SOME DASS . illas a wR ees d deed p p RERO RC REC 2 

1.2.1 A short introduction to the CPU... eee eae ro 2 

1.2.2 Numeral Systems. ... 22... o. lk xn 4 

1.2.3 Converting From One Radix To Another ................. 4 

13 An Empty PONGO +6 a e aca AAA Aaa 7 

LA aaa a aa e EE PON Oe ds E A 8 

¡A A --—LLITITTTTITTT 8 

Mo e o jara CC" 8 

1.3.4 Empty Functions in Practice. ......... o... o... . een. 9 

1:4 Retüming Vales ooo coc ta e RE eee 10 

LATIDOS ur a aa aa 10 

A A BPA AOL at do are, Goan & a She eet chk e 10 

CEA ||" wl io ne ele Bo Eten rg ee 11 

1.5 Hella, world ssc sus bie ed be a n Rok ARA e a A 11 

LAR, eee a bee ea die secu e he wa ee eee eS ELAS 12 

DB ROR s aa acd Sak betae A nue E gre aca a eee ge robe Vas S NUR 19 

LSSARM P" 24 

LSA MIBS. bee 4c bo eh X A ee eS eon ed ee 33 

1,55 CaneisibPi. a suos eo eee ee ee be pd dee ee 39 

IAS ssn keel Gb eR ee ee ee bE eee ee 39 

1.6 Function prologue and epilogue .............. llle 39 

1:6-1 Recursió cc nd ech kd aS or epu eee Eo A E b he wes 40 

1.7 An Empty Function: redux... 0.2688 cn ch ba ek a a 40 

1.8 Returning Values: redux 2.266. 6 ee cce ask ee 40 

I x rco WC "cT 40 


1.9.1 Why does the stack grow backwards? ............... ... 41 
1.9.2 What is the stack used for? .........o.o oo ooo... ....... 42 
1.9.3 Atypical stack layGuk. s osos bee eee bd ee Rh we eee 50 
1.9.4 Noise in stack... ooo. x GERA pex Rn 50 
LASER. ullo oue pee a Gare oe ee eee 55 
1.10 Almost empty function .......... 0.000 0 55 
1.11 printf() with several arguments... 1... aa ee ee 56 
ll ROG ee eek Sd See ead eo Dkk eee o hb ee eS 56 
Del ABM 42 dca el a EE AA 70 
NAMES ea ascii be eed A Bee a ee Ae 77 
LILA COMES. cuu koe mE EE ea eae RO he ewe 85 
LILA BY ME WEY ee Bo eee lee hee o ee ee 87 
LI SCAM cda a Bok bh da wane wha ek aaa a eR heed aaa 87 
1.12.1 Simple example eee a ee Pe e ee 87 
1.12.2 The classic mistake 2.02... 5.65 eke eee eb bbe eRe eS 99 
1.12.3 Global variables o oo ma he ea oe o ae ee 100 
Delt ASCARI AS acc dh bee a hd ed es we OS DO) ob ba Be BAAS 111 
112.58 EXPRES. iu ee eS ak ee ee eR BOCK oe ee 124 
1.13 Worth noting: global vs. local variables .................... 125 
1.14 Accessing passed arguments ............. e... 125 
Um MCI "C "E 125 
MU AS PPP. 128 
Iq ARM Lio oan ew dex; ei geÀ! a exse desee m E OE E ELA a 132 
LAA A cc fac hak PGE Ne Oe OEE eae ae kh aa See 136 
1.15 More about results returning .............. ooo... e... . .. 137 
1.15.1 Attempt to use the result of a function returning void ....... 137 
1.15.2 What if we do not use the function result? .............. 139 
1.15.3 Returning a structure 2.2.0.6. 66 eee o eb bee ka Rn 139 
LIG POETS NN 141 
1.16.1 Returning Values «oso... «conose 141 
1.16.2 Swap Input wales. «us sos] a p RR DEOR m 151 
Lal? GOTO OPEFATOF PDC" --—-——————————— T 152 
1.17.1 e idco nsnsns e X EE Ae BE aped RR he NET 155 
1.17.2 Eee x oues Ros uuu cedex XE eR Re Pee bh ew he 156 
1.18 Conditional (GMS. «usse dee xke x RE RR E xe B Rus RR P 156 
1.18.1 Simple example ou cL oom emma koe cbe X et 156 
1.18.2 Calculating absolute value. ......... o... oo... e... ... 177 
1.18.3 Ternary conditional Operator .......... 0... oo... ..... 180 
1.18.4 Getting minimal and maximal values.................. 184 
A uua soe sor ee cee ede RO R DECR É P ee 190 
L10 O ERKE M bh kee edhe REO A Rewer eine eee BG Oe ae 192 
1.19 Software cracking o oc i ae ee pee ek bee a bee Ree 192 
1.20 Impossible shutdown practical joke (Windows 7)............... 194 
1.21 switch()/case/default ................................ 195 
1.21.1 Small number Of Gases... ae aeo n ARE E ee ek 195 
1212A lotof cases coc had "TE 210 
1.21.3 When there are several case statements in one block ....... 224 
1.21.4 Fall-thraugh 5.5.5.9 ERE x wee 229 
lol. EXPERS. O Shoe ee aed be PE SÉ eee 231 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Laz LOOPS So eae tees A eA Re EE a oe a oe eax 231 
1.22.1 Simple example 2. a ee ee ee 231 
1.22.2 Memory blocks copying routine ........... o... o... .. 246 
1.22.3 Condition check 2.2 ee ed bee bee RÀ ewe eS 249 
L224 Cone SPOT usos cd eee eee du EROR OR ee eee 250 
RS . ouo i Roo o RE ERE ee ee eee ee eS 252 

1.23 More about SECHS o- s- as s n Dok em a ee a 253 
1231 $0180. uu d due Bed kw SD uod Soke we XO Cue db dep p uU e RC 253 
1.23.2 Boundaries of strings -os soc xR p] RA 266 

1.24 Replacing arithmetic instructions to other ones ............... 267 
1.24.1 MültiplicatlBR ilem PE Re eee ee a RES 267 
1245.2 DIVISIBE seme he we we ee OE ee mon m A ee n 274 
1.44.3 EXPRESS: uui s bush assez we Ro x Rom ae Rae Wal el 275 

1:25 FIONA: PONE GATE «uus suelo pere a e ee EORR Rt 275 
1.25.1 IEEE 754 . sek GR y o IIR REGERE Rx RE REO E CER 275 
PAR dc oe a pe ed ede a a Seg EMT 275 
1.25.3 ARM, MIPS, x86/x64 SIMD ......... o... oo... . e... 276 
a ok "TT 276 
1.25.5 Simple example . «208844456052 REEL Ee pote mh Rn 276 
1.25.6 Passing floating point numbers via arguments............ 288 
1.25.7 Comparison example «ioco bru be ae a ee 291 
1.25.8 SOWIE CONSEAAES PPP" --——————— 329 
1.25.9 ROVING sos eke LEER A SE RU xem Amb exc xt E CEES 330 
1.25.10 Stack, calculators and reverse Polish notation ........... 330 
T CS. 11 GODEST o uos dedere x a A eiie dn ERES pe peni POE pruna S 330 
1.25.12 X64 ce cee LL ee E E EGOROR Roo P eee e 330 
J25.13 EXGICIBOS oe ch ee os ome d Fog ee eR PO E Rn 330 

L25 gc o TCU 330 
1.26.1. Simple example 424202) oe eee gom meri por er US eem 331 
1.26.2 Buffer overflOW coros dbi GE eS 340 
1.26.3 Buffer overflow protection methods. .................. 348 
1.26.4 One more word about arrays ............. o... .. .«.. 353 
1.26.5 Array of pointers to strings ............. llle. 354 
1.26.6 Multidimensional arrays ............ e... . «e... .«.. 363 
1.26.7 Pack of strings as a two-dimensionalarray .............. 373 
1.26 8 CONTUSION s ulusm mo e dA RO pO ROB OLEO GR Re 378 
1.26.0 EX@rciSeS 2. nk sock op ee ee eee ee Pe ee eee a 378 

1.27 Example: & bug in Angband 2222 E ae ee RÀ 379 

1.28 Manipulating specific bit(s) ................. llle. 382 
1.28.1 Specifice BIECHECKING 22mm e e ee ee ee eS 382 
1.28.2 Setting and clearing specific bits .................... 387 
1.28.3 SHINS: zu an bE eee POR Ree eee eh hee ORO 397 
1.28.4 Setting and clearing specific bits: FPU example .......... 397 
1.28.5 Counting bits set to L csc 22s AR RRR RR m 403 
1.28.6 COnCIUSIOM uid ei ll s9 Rx ee ead be ETAGE E 421 
(Ee o al A ee Pee ETT 424 

1.29 Linear congruential generator ...........o. o... oo... .. .... 424 


Floating-Point Unit 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


ReGen. and A eee ae A ER 425 
ee A E a e Aa Aa T A i a a AA 426 
1.29.3 32-BIE ARM iu n Laus we ee a ee ee we ee e 427 
1.28.4 MIPS oir ee RGR o e E 428 
1.29.5 Thread-safe version of the example. ............. ls 431 
1:30 SITUELCUEBS. soi oz kate t n Ro E Pe R4 n X Keds bo e x Yn 431 
1.30.1 MSVC: SYSTEMTIME example ..........o oo... o... len 431 
1.30.2 Let's allocate space for a structure using malloc() ......... 435 
1.30.3 UNIX SEFHEE BTE iesu oe se wR kx RR ee a RA D 438 
1.30.4 Fields packing in structure. ........... llle 45] 
1.30.5 Nested structures cora 2 eee be ea e ] hen 460 
1.30.6 Bit fields in a Structure cuius wr tei dome Rhee SE 463 
1.30.7 EXOPCISEB «un sank phd acme ee te ROG Reg ae bee Hales 472 
1:31 The CBE SUCE DUO. sese RR BE ee E TUR ee 472 
1.32 UNIONS SPP A ee ee ee 473 
1.32.1 Pseudo-random number generator example ............. 474 
1.32.2 Calculating machine epsilon ............o o... oo... .. 478 
1.32.3 FSCALE instruction replacement ............ o... o... .. 480 
1.32.4 Fast square root calculation ............. o... ....... 482 
1.33 Pointers: to TUMCHONS uus een a a a A 483 
Ded ILI EMT a we we ale eo ed le aree i as we 484 
a uu sauer fe eee ek uus a3 A A eS ih mos E RR do aa 491 
1.33.3 Danger of pointers to functions cssc; ee 496 
1.34 64-bit values in 32-bit environment ...........o.o ooo... 497 
1.34.1 Returning of 64-bit Valve. ......... o... oo... e... ... 497 
1.34.2 Arguments passing, addition, subtraction............... 498 
1.34.3 Multiplication, división <. -= sa s ose RR AE 502 
1.34.4 Shifting right ossa o bee RR BR eee ee eS 507 
1.34.5 Converting 32-bit value into 64-bit one ................ 508 
1.35 LARGE INTEGER structure Case... ocioso eee I kx ES 510 
Al dB SIME ice ice Bw oe ea A P eta ee helen ER RR eee 513 
ESR VetIDIDEGBBH. coke ee he eA SO eh ee A lee ete Be E Re e 514 
1.36.2 SIMD strlen() implementation .............. llle. 527 
LA? OA DES seek oe An m i i ai eh a A ee oe eh Eee A 531 
LILIA DA cack mi eek AAA E 531 
1.32.2 ARM, à uc d deed geek uror eve o eme d Ra e pp ne LAC CR Rn 540 
1.37.3 Float paint numbers «sooo ob BE x ERR 540 
1.37.4 64-bit architecture criticism .............o...o ooo... .. 540 
1.38 Working with floating point numbers using SIMD............... 541 
1.38.1 Simple example ccoo ee L4 E RO Een 541 
1.38.2 Passing floating point number via arguments ............ 549 
1.38.3 Comparison example ........... o... e... . e... . . .. 550 
1.38.4 Calculating machine epsilon: x64 and SIMD ............. 553 
1.38.5 Pseudo-random number generator example revisited ....... 554 
LABIO SUNNY RD" ee we be ee eS a 554 
1.39 ARM-specific details ............. o... oo... e... . . . .. .. 555 
1.39.1 Number sign (+) before number ........o.. o... o... o... 555 
1.39.2 Addressing modes .......o.o o. ooo... um... 555 
1.39.3 Loading a constant into a register ............. o... ... 556 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1.39.4 Relocs in ARMBA ooo esser g EL RR £i 559 
1.40 MIPS-specific details . ............ o... o... e... e... .. .. 561 
1.40.1 Loading a 32-bit constant into register................. 561 
1.40.2 Further reading about MIPS ...........o oo... oo... ... 563 

2 Important fundamentals 564 
2 Ntedgral datatypes << o e a ee A ee op Ue at dent BER 564 
NIE AA 564 
2.1.2 Nibble AKA Nybble ........... o... o... .. . . . e... . .. 565 
ZLS BYIG "Eq "IIT 566 
21,8 WIUE CHE gic Saisie eh oux SE Rue x BURG RUE na ee E RUNE ad 567 
2.1.5 Signed integer vs unsigned ............ i.e. 567 
2,8 Word gee eek eR ED bea eee ee GR E GG Ree ns d De x EROR OR 567 
2.1 f Address pémieEel" A II geo hob RR E RR 569 
2.1.48 Numbers .... uico oo ER Be ee AA 569 
2.1.9 ANDORXOR 85 MEN duse as bod GE ae e e Poe e 572 

2,2 Endianness. 226 seek ee RR 9 or E xS GR m E bod wo x x ER 572 
2.2.1 BIB. uua ues ean rk Rom n RR Rs dy S E RlA ER NOR RR 572 
22a ic- c-r 572 
2.2.0 EXE asii eh Wed eae Rh dea eae hh ee ER ad 573 

pA CHI np oe tes e oe ote ee heh da Be ed a ee ee ee i 573 
2.2.5 COVERING data s slug raame a eee pRE De a ek dee Rs 573 

AS spp MP "DT 574 
2A CPU 2.22525 kk RR X x Oe doe PEER EEN GS 4o s EP RA 575 
2 LI Branch Precos oi uu sue d ERE pw we ed ee X Res 575 
2.4.2 Data dependencies ......... o... a 575 

AS RaSh TANCTIONS oo ea ae ae eee bea Kop ADA REOR Ed 575 
2.5.1 How do one-way functions work? ....... o... o... e... .. 575 

3 Slightly more advanced examples 577 
3-1 Zero reiste: PCT" 577 
32 Double megallo s o a a wa eei dae dex voe eee ee Ae a d 581 
3.3 CONSE COITBECLEIESS o oo sadaa QUE RIA RA E dex oir E eed 582 
3.3.1 Overapping Const Stings +... ssl ERROR bà RR 584 

3.4 strstr() example ..........:-c lock Rx Re d a ee 585 
29 deor revis ted: uuu dew deb EO me aed a oe A be 586 
3.6 Temperature converting ............... llle 586 
3.6.1 Integer values .....::...---zlxk y m m mm RR xk dE 587 
3.5.2 Floating-point values iiu su rx mm Ex 589 

3:7 HOONSECI AUMDES coi oa en e aaa 592 
a AN 592 
J1- EKME A RR Rem abaco wed m RR RN dus 597 
EXC QUINN AERE S DIL URTRMTLI 17 — 0701527770117 ed 600 

3,8 CRC32 calculation example o... izo. cow REA 601 
3.9 Network address calculation example ...................... 605 
3.9.1 calc network address() .........: osse RR ea ee 607 
27 NOMA IBI ora ac uie dej nonse oe secar gne vix Rep oe NR 607 
3:9:3 print aS IP) «sio Rl RR ee ew ee 609 
3.9.4 form netmask() and set bit()..............o. o... oo... 611 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


3.00 SUMMARY o i ome hk eae ae ee ee xum o ue dx x RE a 612 
3.10 Loops: severaliterators. .......... o... .. . . . . . . . .. .. 612 
2.10.1 Three iterators luus ue rr ad 613 
3.10.2 Twò iterators. .. a ee ee Ee ee 613 
3.10.3 Intel C++ 200 ES ee re Ae eG ee ee 616 
Soll DUNS TENIA... lle] x ee eRe be ee eee 617 
3.11.1 Should one use unrolled loops? ..................... 621 
3.12 Division using multiplication . .......... o... ooo... e... ... 621 
SALA os da dc a a A 621 
2.12.2 HOw WORKS cavar AA 623 
JAAS NN 623 
LA UPS "t 625 
JAAS NS 625 
3.13 String to number conversion (atoi()) ...................... 626 
3.13.1 Simple example 2.2. eee ee ee o9 ERG Rx rra. 626 
3.13.2 A slightly advanced example ............... l.l ess. 630 
3.13.3 Exercise 2.2. bb ee eed eee Pee eee E RR Ud Eee ec Dog od 634 
214 A ou ee e ohm m RR Hc R Re R BO CX GR P Eck 634 
3.14.1 Strings and memory functions ......... o... o... e... .. 635 
LNSCR Du EM CDL A POSS we Riga de hes 645 
3.16 Branchless abs() function ............................. 648 
3.16.1 Optimizing GCC 4.9.1x64 ..........o. ooo... .... .... 649 
3.16.2 Optimizing GCC 4.8 ARM64 o .oo.oopcciain ee eee ee 649 
217 Varadic TUACENONS ucc EE a mE PE x 650 
3.17.1 Computing arithmetic mean ............ o... o... .. 650 
3.17.2 vprintf() function case «lucus de UR ed 655 
PILS PED ESSE... duos surge CE EUR ee he ede whe 657 
3.17.4 Format string exploit 2.244.624 22 be ku omn RR 657 
3:18 Strings A DT TM 658 
3.18.1 x64: Optimizing MSVC 2013 .................. c.n. 660 
3.18.2 x64: Non-optimizing GCC 4.9.1... ........... llle. 662 
3.18.3 x54: Optimizing GCC 4.98 T. osse cuum mc xt RR Rn 663 
3.18.4 ARM64: Non-optimizing GCC (Linaro) 4.9 ............... 664 
3.18.5 ARM64: Optimizing GCC (Linaro) 4.9 .................. 666 
3.18.6 ARM: Optimizing Keil 6/2013 (ARM mode) ............... 667 
3.18.7 ARM: Optimizing Keil 6/2013 (Thumb mode) ............. 667 
3.18.8 MIPS «cse kc peek ER D4EGdOEG Roue Pb ox ces 668 
3,19 Toupper UNCON uus s Yok aoe a 670 
ABARCA era sonat RG Gd x p REG ERE Rok R Rb ob PG x RE 671 
2.18.3 ABI auri us eee A 673 
3.19.3 Using bit Operations «susce 5 6 kee es mee ee ORE An i 674 
3.19.9 SUNMA a «uuu lues Te eek eee a RARO OR bee RU d 676 
LO ej el CEP 676 
320.l IGXE SIDES. uuu iu eremo REOS ORBE ER RO RE Ee eB ee Y 676 
2.20.2 Executable code Lol zi n REESE Remedy RE E ERE 677 
3.20.3 Virtual machine / pseudo-code ......o.o.o.o. ooo. o... e... 681 
3.20.4 Other things ta mention... coco ro d RR 681 
3.20.5 Exercise coooa ee ee eee LEX E eh ee wee we ee 681 
Bee "CLIP 682 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Liam c. i ak a CERO tee Ee ee Ale ee SEELEY 682 
3.21.2 OSEE. «uua roe uk emm QURE EL ale ee RC UR Sakata ais 703 
ESA I0 AL 705 
S413 STL e bad ae Rd 93k cx eS Pe eh so np D De m ROSEO GR 706 
CNN I. o MT "TESTIS 751 
3.22 Negative array indices ............ e... . .. . . . . .. .. . .. 752 
3.22.1 Addressing string from the end. ......... oo... oo... .. 752 
3.22.2 Addressing some kind of block from the end ............. 753 
3.22.3 Arrays started at 1... ........ oo oo... o... .... .... 753 
3.23 More about pointers -a ss s isma kona h o mme AA 756 
3.23.1 Working with addresses instead of pointers.............. 757 
3.23.2 Passing values as pointers; tagged unions .............. 760 
3.23.3 Pointers abuse in Windows kernel ............o. 0... o... 761 
3.23 MB DONES. o ea s hoes ee eee ee bee Pee ee aS 767 
3.23.5 Array as function argument ........o.o. o... o... . «e... 773 
3.23.6 Pamter to a TURCO cuu us snm a ee dde 774 
3.23.7 Pointer to a function: copy protection ................. 775 
3.23.8 Pointer to a function: a common bug (ortypo)............ 776 
3.23.9 Pointer as object identificator. .......... o... o... ..... 776 
3.23.10 Oracle RDBMS and a simple garbage collector for C/C++ .... 778 
3.24 Loop ppümizationS . <. s eke cdsa eae Re Re Oe a a 779 
3.24.1 Weird loop optimization ............. o... e... .... 779 
3.24.2 Another loop optimization .... sess GER RR 781 
3.25 More about structures ......... llle 783 
3.25.1 Sometimes a C structure can be used instead of array ...... 783 
3.25.2 Unsized array in Cstructure.......... o... e... . . eee 785 
3.25.3 Version of C Structure . oo nu nue oe e EE EROR 786 
3.25.4 High-score file in "Block out" game and primitive serialization . 789 
3.26 memmove() and memcpy() ....... lees 794 
3.26.1 Anti-debugging trick... saaa aa 796 
3.27 SOU) e o- s a e be aa a a m Ae 3. um e ws 796 
3.28 Other weird Stack hacks «occi iieaoe rra eem kc eed Ce i à 799 
3.28.1 Accessing arguments/local variables of caller ............ 799 
3.28.2 Berurning String ceci eee dee dde mA ER RE E i 801 
S28 OBEDMP Lu a RE Be eke og Ron mx de a a a i RR Rae RO REOR S d 803 
CAM LU TEE 806 
3.20.2 GCC cute cack hee eee edb e ewe PEERY Se Poe eee a 809 
3,30 Signed division USING SHINS uuu uo eh E ee ee ee 811 
3.31Anotherheisenbug .......... llle 813 
3.32 The case of forgotten retu s sesso m Rd ER 814 
3.33 Homework: more about function pointers and unions ........... 819 
3.34 Windows 16-bit .............. llle 821 
3.34.1 Example# Lm 821 
3-34.22 Example FA vo ooe kaa he a ie AREER e ee 822 
284.3 Example aed lu nuu e i AeA Eo ee ea ege A 822 
3.34.4 Example #4 A eee ae E E a AR a OE e xn a G 824 
3.34.5 Example ES. uen tee eet MERE T ee Ron E p E a ee 827 
3.34.6 Example 46 ooo so iocos x ee ieee EE 831 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


4 Java 836 
NB | Gen Dae aaa at wa A El a RR RU ee Gee UR e e EC QURE i CS 836 
Zl a o suus ndm he Remy ex Rm mom eee E 836 
4.1.2 Returning a value .............. e... e 837 
4.1.3 Simple calculating functions ............. llle. 843 
4.1.4 JVM^ memory model... zo RR RR 846 
1.1.5 Simple function calling «ullum 846 
4.1.6 Calling Bbespil.-l2.223 a x Xe eR Roe DC E SX 849 
4.1.7 Linear congruential PRNG? ...........o.o.ooooooo ooo... 849 

4. 1,8 Conditional JUMPS «eun a A 851 
4.1.9 Passing arguments .. ome RRR a o o» xx now onm a 854 
ALIO BMWS soso or ee Oh e ee ee 855 
LONE AE 856 
4.1.12 Switch). a a a 859 
AAS ANYS eo aia i i eaaa We a Ee a ee aa a 860 
LONE Lg o cd A a ee ee A ee m 871 
4.1.15 Exceptions .. soe eee n DEG GR ERR Ud E aa 874 

S.I I0 EROS 0g ow RUP a Re doge dk pe boe RR wh 878 
4.1.17 Simple patching : cessie asea ciega RR RR 881 
4.118 A 887 

5 Finding important/interesting stuff in the code 888 
5.1 Identification of executable files ............ o... ooo... .... 889 
5.1.1 Microsoft Visual C++ sx xara eee eR EE RR Ee 889 
a o "MCCC 889 
5.1,3 Intel Fora... a oe Ro ee eee ee ee owe 9E 890 
5.1.4 Watcom, Open MWaECOIY «us x ewe ea n Eo RD ae 890 
5.15 Borland x uuu bbe eRe A pum ae Phe ee eS 890 
5.L5 Other known DLES «uou d mm a a me ke AA 892 

5.2 Communication with outer world (function level) ............... 892 
5.3 Communication with the outer world (Win32).................. 892 
5.3.1 Often used functions in the Windows API ................ 893 
5.3.2 Extending trial period. ............. 0.000022 894 
5.3.3 Removing nag dialog box ............ llle 894 
5.3.4 tracer: Intercepting all functions in specific module ......... 894 

Se IISc PCM "Cm 895 
5.4.1 Text Sings: 2 nec ce eee eee IRRAG ee Pee ee ed 895 
5.4.2 Finding strings in binary ............ oo... a a .... 901 
5.4.3 Error/'debug messages ........-.- o... .. e... 903 
5.4.4 Suspicious magicstrings. .......... llle 903 

5.5 Calls tO WSSePHEI uuu decade uk RES ede e arae RE X x dela e A 904 
Ve gj PPP 905 
5-6.1 Magic HUME... cis doe Gee dah mo e dede Ree x Sx 906 
5.6.2 Specific CONSTAMÉS «occiso cor Dae RR Rune RR 908 
5.5.3 Searching for constanis 2.4424 400066 ed bebe e R 908 

5.7 Finding the right instructions ........... o... e... . e... . . .. 908 
5.8 Suspicious code patternS.......... ooo... . e... . .. . . 4... . 910 


2Java Virtual Machine 
3Pseudorandom Number Generator 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


5.8.1 XOR INSTRUCHONS eue 4 be o ee BEE EEE I 910 
5.8.2 Hand-written assembly code ............. llli. 911 

5.9 Using magic numbers while tracing ........... o... o... ..... 912 
DU LOOPS cierra ke thee Gow we gm Ried RO» dee n m 4 D Dow sees 912 
5.10.1 Some binary Tile patterns «uec Rr RR Rm 914 
5.10.2 Memory "snapshots" comparing ......... o... o... e... 922 
BILE detection .... cg bee b's OSs a EUR 924 
5.11.1 Incorrectly disassembled code ................ eens 924 
5.11.2 Correctly disassembled code ..........o.o ooo... oe... 930 
A CHINE: lisse ee ee RAE OR Be ea BAER XY ES. 930 
5.12.1 Generale. secun mx ERE aa BE E 930 
5.12.2 Order of functions in binary code ............ o... .... 930 
5.123 SI AI o- ó esia a ae ha ee Pa ee ee ale S 931 
SA bl a a A ee ae ee a e a 931 
5.12.5 Crash OM purpose :.2-2.2 ck RR RA 931 

6 OS-specific 932 
6.1 Arguments passing methods (calling conventions) .............. 932 
B. Ig EHBEL o ee oe eo RA Ww Xu ee eR REUS eee E E EE RU 932 
Gio CHI gacck dds yds aa cit id ya ss 932 
AE A aa i iai iea i ai n a A E ai a ae ae i i a ie a g a 934 
p.14 tbiscall cas GR ae eke wee eRe RE Ex A S 935 
Bel XGB-DA cia ke xum RE OP oe eae n Sm EUR nA UR 936 
6.1.6 Return values of float and doubletype ................. 939 
6.1.7 Modifying arguments < sa soc, Ero e» icy E x ah 939 
6.1.8 Taking a pointer to function argument ............. sss 941 
6.1.9 Python ctypes problem (x86 assembly homework) .......... 943 
6.1.10 Cdecl example: aDllL...........o.o.o. oo ooo... .. 943 

6.2 Thread Local Storage «22cm nmEG ee A 944 
6.2.1 Linear congruential generator revisited ................. 944 

6.3 System calls (SySCall-S) ............. ooo. es 950 
[CS NN evoca a AA e AA 951 
Mies ai sos Na Ae DR Sa ae ee A Ak RA 951 

A Aum MEME A En NE Gp og ae Ge a 952 
6.4.1 Position-independent code ................... e... .. 952 
6.4.2 LD PRELOAD hack in LINUX. ck ee ee Rt 955 

6.5 Windows MT 222: ca ee bee ee Ree En eee ee ee 958 
isl CRT PWNS cuu uus ee Ae A ee aed Do ee a E e e 958 
6.5,2 WINS2 PE ek he eee Ro Eee Ee Me hk eee Y 963 

n. 5.3 Windows SER uus eka i Eu ERS De ae A ES 973 
6.5.4 Windows NT: Critical section ............. o... ...... 1002 

7 Tools 1005 
TlBinaryanalysis ... 22.22: s o ee ee ee eee Ee 1005 
LL DISASSEMBIGKS "I 1006 
7.1.2 Decompllet$. oso. ER REE AA 1006 
71.1.3 Patch comparison eim. usse a ok y Ow eae doe ee 1006 

12 Live analySi$.. >s ccoa eee ERE ee ee ee eee ed dew eee 1006 


^Instruction Set Architecture 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


V2.1 a a ag kk Be eek te Ee a we ee BEE EEO 1007 
7.2.2 Library Calls tracitig «uuu oe Da we age AA RE 1007 
1.2.2 System Calls tracing iussus nee ee dad mo mh R4 RERO 1007 
7.2.4 Network sniffing ........... «<<... .. ... 9 Re 1008 
pss Tar 2 ETC 1008 
72,8 Valgrind «22 nasi eae oiim cA RR P ee eee 1008 
PAT EUREO "PC 1008 

Fed Other taol6 «ee dee aah eee ei ana a p Lek eee e Ron RO Pw x ee OR n 1009 
[sc gp P le eek Bs CRS De ee doe ea ee 1009 
puces uu: oC" 1009 

7.4 Do You Think Something Is Missing Here? ............o. o... ... 1009 
8 Case studies 1010 
8.1 Mahjong solitaire prank (Windows 7) .......... aa 1011 
8.2 Task manager practical joke (Windows Vista) .................. 1013 
9.2 1 Using LEA tò nad valles. .. coco rrr d RR 1017 

8.3 Color Lines game practical joke ................. len 1018 
8.4 Minesweeper (Windows XP) ........ llle 1021 
8.4.1 Finding grid automatically... coo. ss ae ok x PRG iR a 1028 
GA 2 EXGICISOS a e nu dla ne Ge VER RR RUE a qp EE ES E a a 1029 

8.5 Hacking Windows ElBEK «sol dere] gem] eee Re en 1029 
8.6 (Windows 7) Solitaire: practical jokes... .......... o... ...... 1039 
A a4 ares oe he ack te PE E REOR eh D SE EOS A Res 1039 
8.6.2 53 cards ¿cocaina opi RR ee RES 1047 

8.7 FreeCell prank (Windows Y) «usc oll ee ae 1048 
B.LIPArb| eee eva ke bee ee iy eee ee Ee Mee eee eee eS 1048 
8.7.2 Part Il: breaking the Select Game submenu..............-. 1053 
B.BDongles : 2c eee bab hd RR GG A ee bee ee ee 1055 
8.8.1 Example #1: MacOS Classic and PowerPC ............... 1055 
8.8.2 Example #2: SCO OpenServer. .......... llli. 1065 
3.8-3 Example #3: MS-DOS on ee Be eR ee eee A 1078 

8.9 Encrypted database case #1 .................. eee es 1085 
8.9.1 Base64 and entropy......... o... . e... . e... 1085 
8.9.2 Is data compressed? ....... o... a a 1087 
8.9.3 Is data encrypted? .. 22... ee ee 1088 
ER ATIUM 1089 
8.9.5 Cipher Feedback mode... ...... 0... 0 eee ees 1092 
8.9.6 Initializing Vector >o ee ww Re DERE 1094 
8.9.7 Structure of the buffer «5... 56 eee eee ke RR EGO 1095 
8.9.8 Noise atthe end ..........o. o... e... . . . e. eme... 1098 
as o sous ho a eG Eo ewe a ESSE a i 1099 
8.9.10 Post Scriptum: brute-forcing IV? .. a.a anaana ooo oo... 1099 
8.10 Overclocking Cointerra Bitcoin miner .............. sen 1100 
8.11 Breaking simple executable code encryptor...............-.. 1106 
8.11.1 Other ideas to consider... sco ne oor REEL 1111 
B.12 SAP. ek ee ue eR eee eic4dkEGZd4dxox bit XE Ro 1112 
8.12.1 About SAP client network traffic compression ............ 1112 
8.12.2 SAP 6.0 password checking functions ................. 1127 


5Initialization Vector 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


8.13 Oracle RDBMS . ou noui AVR REESE ER Bee ae ce E SERERE 1132 
8.13.1 V$VERSION table in the Oracle RDBMS ................. 1132 
8.13.2 X$KSMLRU table in Oracle RDBMS .................... 1142 
8.13.3 V$TIMER table in Oracle RDBMS ................. ens 1144 

6.14 Handwritten assembly code .... sss] xn 1149 
8.14.1 EICAR test file. ....... naaa a 1149 

hod np c" EPIIT 1150 
8.15.1 10 PRINT CHR$(205.5+RND(1));: GOTO 10 ............. 1151 
8.15.2 Mandelbrot set .............. es 1155 

8.16 A nasty bug in MSVCRT.DLL < su i ecr PrE selle 1161 

8-17 DME o -s a ak A ASR he ee DER Rae Dus LA Lea Gas 1169 

9 Examples of reversing proprietary file formats 1170 

9.1 Primitive XOR-SNcryption . -< eae org RR RO RR EROR eS 1170 
9.1.1 Simplest ever XOR encryption ......... o... o... . ee ee 1170 
9.1.2 Norton Guide: simplest possible 1-byte XOR encryption ...... 1172 
9.1.3 Simplest possible 4-byte XOR encryption ..............00. 1175 
9.1.4 Simple encryption using XOR MaSK............o o... .... 1179 
9.1.5 Simple encryption using XOR mask, case ll. .............. 1188 
9.1.6 Homework ........ lees hs 1195 

9.2 Information Entropy ——E cC 1195 
9.2.1 Analyzing entropy in Mathematica ................-..-. 1196 
Bod CONCISO ica a suh A aA REX EO X eeu rae doe ex he eG a 4 1206 
E «iuc xdi xm oko RRR E X A X hae a 1206 
9.2.4 A word about primitive encryption like XORing ............ 1206 
9.2.5 More about entropy of executable code ................. 1206 
S CER ON 1207 
9.2.7 Mare examples coso ca ee ee EE RA 1207 
9.2.8 Entropy of various Files... osas 1207 
9.2.9 Making lower level of entropy ............ oo... . e... 1209 

9.3 Millenium game save fille. ........... o... oo... .. «e... . . . 1210 

9.4 fortune program indexing file .............. o... o... e... ... 1217 
DAT PACKING A RW eae DPE Rea ag we kk Pw aa 1223 
CI 2 The NES PC" 1224 

9.5 Oracle RDBMS: .SYM-files ........... sees 1224 

9.6 Oracle RDBMS: .MSB-files ........... lees 1237 
S.l SUMMI 226 e455 oR ee eed DD eee x £e ee ea 1243 

OF EKES oaa hw sw asin ee Se dee ee ae eek, a Aa afa 1243 

9.8 Further reading +. 22.26 228 o ee eee ee eS 1243 

10 Dynamic binary instrumentation 1244 

10.1 Using PIN DBI for XOR intercepti0N. .......... o... oo... ... 1244 

10.2 Cracking Minesweeper with PIN. ..............o oo... e... .. 1248 
10.2.1 Intercepting all rand() calls ................. o... ... 1248 
10.2.2 Replacing rand() calls with our function ................ 1249 
10.2.3 Peeking into placement of mines ................. o... 1250 
imm ac oco MM MCDC--CDc-c---————T 1253 

10,3 Building Intel Pii << oc om RR maim eee 1253 

10.4 Why "instrumentation"? .................. leen 1254 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


11 Other things 1255 
11.1 Using IMUL over MUL .....:..2c-ozsR RR RR RRRAEE 1255 
11.1.1 MulDiv() function in Windows ............ nnn 1256 
11.2 Executable files patching ............ o... ooo... e... .. 1256 
Al o oe e CETT 1256 
11.3 Function arguments number statistics ...........o o... o... .. 1257 
11,4 Compiler MINSI «uus s eR boe A ee da Em 1258 
11.5 Compiler's anomalies ................ llle 1258 
11.5.1 Oracle RDBMS 11.2 and Intel C++ 10.1 ................ 1258 
115.2 MS VE A o da e AA 1259 
11.5.3 Hol2 im MS VE ZOLL asun aa we 1259 
AA A AN 1261 
iE Gru cios eek AAA AAA 1261 
11.7 8086 memory model o eceso eee ee ee EORR Rt 1264 
11.8 Basic blocks reordering ............... o... e... e... . + 1265 
11.8.1 Profile-guided optimization ........... 0... o... ..... 1265 
11.9 My experience with Hex-Rays 2.2.0 .......0..o o... oo... e... .. 1267 
AAA ed od D a ae aa ee eee ee Bee 1267 
11.9.2 Odd peculiarities . 2.22... ee eRe kom e 1269 
11.9.3 a A ad BO UR BOGE waged AERE E 1271 
ILIA COMA RM 1273 
11.9.5 Data PES. sk bh eid a RR OR a a Rie dx x a R ed aa Go 1274 
11.9.6 Long and messed expressions ... aaau ... ... 1274 
11.9.7 De Morgan's laws and decompilation.................. 1275 
Hat. Olas see PEDE PCT" 1277 
11.9.9 SUMMA P MP" c 1277 
11.10 Cyclomatic Complexity uoo bee Rss RR RE ae A 1277 
12 Books/blogs worth reading 1281 
12.1 Books and other materials ............. o... o... eee ees 1281 
12.1.1 Reverse Engineering ......... o... «o... . . . 2... ... 1281 

12 LA OS ai e A aa 1281 
(CAE IS m PL" 1282 
12.1.4 x86 / xBO-O4 oou sues ee dp E a a a 1282 
12.1.8 BRM wees Sha ka RR Pee e & O34 Pob ox REOR 1282 
12.1.6 Assembly language «css doe ER RR y 1283 
12.17 dV wk ew rr s xe: YP a ee we oe aa A 1283 
LA TET 1283 
12.1.9 Programming in general ........... o... o... e... ... 1283 
12.1.1D Cryptography -e cues lxx da RR X 1283 
12.1.11 Something even easier ............ o... .. e... . .« . . 1283 

13 Communities 1234 
Afterword 1286 
13,1 QUESTIONS? -o aa ao 22... ebb Pe ba ee hee DEGERE 1286 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Appendix 1288 
Wwe A" "-"——-———————————— TITLE 1288 
Nerd "TC" 1288 

.1.2 General purposeregisters. .......... llle. 1288 

clea PU o uie eb eR eee P ROB OR Dp RE ERU n 1293 

LA SIMD registers .. 22 sso RE cR Rn 1295 

.1.5 Debugging registers ........ 0.0.0. ce ee 1295 

ALO INBEPUCTIONS + o o ao cc Be eee ek bh Rew eee 1297 

ghee o a aea go ane Gal ee nd dao Bm Gd a Gees Bae bie Gee be ae 1313 

Doro aos ee eae Db te eR EAA AW ORE OO eee BAG Se Ee a eS 1315 
Posuit: sc hi eR ae OPE Sea ae kd ewes 1315 

Cri icon MDC" 1315 

2.3 32-bit ARM DXAFCHISZ] oca a we eee eae odorem RR Ree m nin 1316 

.2.4 64-bit ARM (AArch64) ....... lees 1317 

22S INGEPUCTIONS -o na eee ER Eee De ee eH 1318 
ee QM "APPLET 1318 
Registers... 5222s sc lon lo REGRERALeAe4 d eee EES 1318 

A n MEET 1319 

.4 Some GCC library functions ........... lle 1320 

-5 Some MSVC library functions -saose m soa o n xem 1320 

0 COS AEB MEC 1321 

D 4M P" 1321 
Prices MMC TT 1321 
DIM a ba aus Ae SA X BUR ES aca d e a 1322 
Eabb cuml derunt eue a UP ea eee B E pud aa 1322 

GS GOB A ON 1322 
Acronyms Used 1325 
Glossary 1332 
Index 1335 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


xvi 


Preface 


What is with two titles? 


The book was named "Reverse Engineering for Beginners" in 2014-2018, but always 
suspected this makes readership too narrow. 


Infosec people know about "reverse engineering", but l've rarely hear the "assem- 
bler" word from them. 


Likewise, the "reverse engineering" term is somewhat cryptic to a general audience 
of programmers, but they know about "assembler". 


In July 2018, as an experiment, I’ve changed the title to "Assembly Language for 
Beginners" and posted the link to Hacker News website®, and the book was received 
generally well. 


So let it be, the book now has two titles. 


However, I’ve changed the second title to "Understanding Assembly Language", be- 
cause someone had already written "Assembly Language for Beginners" book. Also, 
people say "for Beginners" sounds a bit sarcastic for a book of —1000 pages. 


The two books differ only by title, filename (UAL-XX.pdf versus RE4B-XX.pdf), URL 
and a couple of the first pages. 


About reverse engineering 


There are several popular meanings of the term "reverse engineering": 
1) The reverse engineering of software; researching compiled programs 


2) The scanning of 3D structures and the subsequent digital manipulation required 
in order to duplicate them 


3) Recreating DBMS” structure 
This book is about the first meaning. 


Prerequisites 
Basic knowledge of the C PL®. Recommended reading: 12.1.3 on page 1282. 


Exercises and tasks 
...can be found at: http://challenges.re. 


Praise for this book 
https://beginners.re/£praise. 


Shttps://news.ycombinator.com/item?id=17549050 
7Database Management Systems 
8Programming Language 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


xvii 


Universities 


The book is recommended at least at these universities: https://beginners.re/ 
#uni. 


Thanks 


For patiently answering all my questions: SkullCODEr. 


For sending me notes about mistakes and inaccuracies: Alexander Lysenko, Fed- 
erico Ramondino, Mark Wilson, Razikhova Meiramgul Kayratovna, Anatoly Prokofiev, 
Kostya Begunets, Valentin “netch” Nechayev, Aleksandr Plakhov, Artem Metla, Alexan- 
der Yastrebov, Vlad Golovkin?, Evgeny Proshin, Alexander Myasnikov, Alexey Tre- 
tiakov, Oleg Peskov, Pavel Shakhov, Zhu Ruijin, Changmin Heo, Vitor Vidal, Stijn 
Crevits, Jean-Gregoire Foulon!?, Ben L., Etienne Khan, Norbert Szetei!!, Marc Remy, 
Michael Hansen, Derk Barten, The Renaissance!?, Hugo Chan, Emil Mursalimov, Tan- 
ner Hoke, Tan90909090@GitHub, Ole Petter Orhagen, Sourav Punoriyar, Vitor Oliveira, 
Alexis Ehret, Maxim Shlochiski, Greg Paton, Pierrick Lebourgeois, Abdullah Alomair, 
Bobby Battista, Ashod Nakashian. 


For helping me in other ways: Andrew Zubinski, Arnaud Patard (rtp on #debian- 
arm IRC), noshadow on #gcc IRC, Aliaksandr Autayeu, Mohsen Mostafa Jokar, Peter 
Sovietov, Misha “tiphareth” Verbitsky. 


For translating the book into Simplified Chinese: Antiy Labs (antiy.cn), Archer. 
For translating the book into Korean: Byungho Min. 
For translating the book into Dutch: Cedric Sambre (AKA Midas). 


For translating the book into Spanish: Diego Boy, Luis Alberto Espinosa Calvo, Fer- 
nando Guida, Diogo Mussi, Patricio Galdames, Emiliano Estevarena. 


For translating the book into Portuguese: Thales Stevan de A. Gois, Diogo Mussi, Luiz 
Filipe, Primo David Santini. 


For translating the book into Italian: Federico Ramondino!”, Paolo Stivanin!^, twyK, 
Fabrizio Bertone, Matteo Sticco, Marco Negro? , bluepulsar. 


For translating the book into French: Florent Besnard!ó, Marc Remy?’, Baudouin 
Landais, Téo Dacquet??, BlueSkeyeEGitHub??. 
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For translating the book into Polish: Kateryna Rozanova, Aleksander Mistewicz, Wik- 
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For translating the book into Japanese: shmz@github2?,4ryuJP@github?*. 
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Kang, Mal Malakov, Lewis Porter, Jarle Thorsen, Hong Xie. 
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Thanks also to all the folks on github.com who have contributed notes and correc- 
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Many TEX packages were used: | would like to thank the authors as well. 


Donors 


Those who supported me during the time when I wrote significant part of the book: 


2 * Oleg Vygovsky (504-100 UAH), Daniel Bilar ($50), James Truscott ($4.5), Luis Rocha 
($63), Joris van de Vis ($127), Richard S Shultz ($20), Jang Minchang ($20), Shade At- 
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mini-FAQ 


Q: Is this book simpler/easier than others? 


20https://github.com/DSiekmeier 
2lhttps://github.com/JAngres 
22https://github.com/PolymathMonkey 
23https://github.com/shmz 
24https://github.com/4ryuJP 
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A: No, it is at about the same level as other books of this subject. 


Q: I'm too frightened to start reading this book, there are more than 1000 pages. 
"...for Beginners” in the name sounds a bit sarcastic. 


A: All sorts of listings are the bulk of the book. The book is indeed for beginners, 
there is a lot missing (yet). 


Q: What are the prerequisites for reading this book? 
A: A basic understanding of C/C++ is desirable. 
Q: Should | really learn x86/x64/ARM and MIPS at once? Isn’t it too much? 


A: Starters can read about just x86/x64, while skipping or skimming the ARM and 
MIPS parts. 


Q: Can | buy a Russian or English hard copy/paper book? 


A: Unfortunately, no. No publisher got interested in publishing a Russian or English 
version so far. Meanwhile, you can ask your favorite copy shop to print and bind it. 
https://yurichev.com/news/20200222 printed RE4B/. 


Q: Is there an epub or mobi version? 


A: No. The book is highly dependent on TeX/LaTeX-specific hacks, so converting to 
HTML (epub/mobi are a set of HTMLs) would not be easy. 


Q: Why should one learn assembly language these days? 


A: Unless you are an OS? developer, you probably don't need to code in assembly— 

the latest compilers (2010s) are much better at performing optimizations than hu- 
27 

mans ^'. 


Also, the latest CPU??s are very complex devices, and assembly knowledge doesn't 
really help towards understanding their internals. 


That being said, there are at least two areas where a good understanding of assembly 
can be helpful: First and foremost, for security/malware research. It is also a good 
way to gain a better understanding of your compiled code while debugging. This 
book is therefore intended for those who want to understand assembly language 
rather than to code in it, which is why there are many examples of compiler output 
contained within. 


Q: | clicked on a hyperlink inside a PDF-document, how do | go back? 
A: In Adobe Acrobat Reader click Alt--LeftArrow. In Evince click "«" button. 
Q: May | print this book / use it for teaching? 


A: Of course! That's why the book is licensed under the Creative Commons license 
(CC BY-SA 4.0). 


Q: Why is this book free? You've done great job. This is suspicious, as with many 
other free things. 


?6 Operating System 
?7A very good text on this topic: [Agner Fog, The microarchitecture of Intel, AMD and VIA CPUs, (2016)] 
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A: In my own experience, authors of technical literature write mostly for self-advertisement 
purposes. It's not possible to make any decent money from such work. 


Q: How does one get a job in reverse engineering? 


A: There are hiring threads that appear from time to time on reddit, devoted to RE??. 
Try looking there. 


A somewhat related hiring thread can be found in the "netsec" subreddit. 
Q: I have a question... 


A: Send it to me by email (my emails). 


About the Korean translation 


In January 2015, the Acorn publishing company (www.acornpub.co.kr) in South Korea 
did a huge amount of work in translating and publishing this book (as it was in August 
2014) into Korean. 


It's available now at their website. 


The translator is Byungho Min (twitter/tais9). The cover art was done by the artistic 
Andy Nechaevsky, a friend of the author: facebook/andydinka. Acorn also holds the 
copyright to the Korean translation. 


So, if you want to have a real book on your shelf in Korean and want to support this 
work, it is now available for purchase. 


About the Persian/Farsi translation 


In 2016 the book was translated by Mohsen Mostafa Jokar (who is also known to 
Iranian community for his translation of Radare manual??). It is available on the 
publisher's website?! (Pendare Pars). 


Here is a link to a 40-page excerpt: https://beginners.re/farsi.pdf. 


National Library of Iran registration information: http://opac.nlai.ir/opac-prod/ 
bibliographic/4473995. 


About the Chinese translation 


In April 2017, translation to Chinese was completed by Chinese PTPress. They are 
also the Chinese translation copyright holders. 


The Chinese version is available for order here: http: //www.epubit.com.cn/book/ 
details/4174. A partial review and history behind the translation can be found here: 
http://www.cptoday.cn/news/detail/3155. 


The principal translator is Archer, to whom the author owes very much. He was 
extremely meticulous (in a good sense) and reported most of the known mistakes 


29reddit.com/r/ReverseEngineering/ 
30http://rada. re/get/radare2book- persian. pdf 
3lhttp://goo.gl/2Tzx0H 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


xxi 


and bugs, which is very important in literature such as this book. The author would 
recommend his services to any other author! 


The guys from Antiy Labs has also helped with translation. Here is preface written 
by them. 


Isn't the book book outdated already? 


l've been asked often: Why are the compilers in the RE4B book are that old? Is the 
book itself outdated? 


Because work on the book was started at the beginning of 2010. (This is why old 
MSVC 2008 is used in some places.) 


It is not outdated, because: 


1) Compilers don't evolve that fast, so the code generated by MSVC 2010 and by 
the latest MSVC may not differ much. 


2) What you will reverse (malware, and the software in which you will hunt for vul- 
nerabilities), for sure, is not always compiled by fresh compilers. 


As far as | can recall, Oracle RDBMS (when | was still worked with it) was built using 
older versions of Intel C++. There is also a suspicion that the latest versions of 
Windows are also not always compiled by the latest versions of MSVC. 


And it is not necessary to follow all the steps in the book exactly, so it is not so 
important to use the same compilers. Use the compilers that are already installed 
in your OS. And also, there is always Compiler Explorer. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Chapter 1 


Code Patterns 


1.1 The method 


When the author of this book first started learning C and, later, C++, he used to 
write small pieces of code, compile them, and then look at the assembly language 
output. This made it very easy for him to understand what was going on in the code 
that he had written. !. He did this so many times that the relationship between the 
C/C++ code and what the compiler produced was imprinted deeply in his mind. It's 
now easy for him to imagine instantly a rough outline of a C code's appearance and 
function. Perhaps this technique could be helpful for others. 


By the way, there is a great website where you can do the same, with various 
compilers, instead of installing them on your box. You can use it as well: https: 
//godbolt.org/. 


Exercises 


When the author of this book studied assembly language, he also often compiled 
small C functions and then rewrote them gradually to assembly, trying to make their 
code as short as possible. This probably is not worth doing in real-world scenarios 
today, because it's hard to compete with the latest compilers in terms of efficiency. 
It is, however, a very good way to gain a better understanding of assembly. Feel 
free, therefore, to take any assembly code from this book and try to make it shorter. 
However, don't forget to test what you have written. 


Optimization levels and debug information 


Source code can be compiled by different compilers with various optimization levels. 
A typical compiler has about three such levels, where level zero means that opti- 


ln fact, he still does this when he can't understand what a particular bit of code does. A recent example 
from the year 2019: p += p+(i&1)+2; from the "SATOW" SAT-solver by D.Knuth. 
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mization is completely disabled. Optimization can also be targeted towards code 
size or code speed. A non-optimizing compiler is faster and produces more under- 
standable (albeit verbose) code, whereas an optimizing compiler is slower and tries 
to produce code that runs faster (but is not necessarily more compact). In addition 
to optimization levels, a compiler can include some debug information in the result- 
ing file, producing code that is easy to debug. One of the important features of the 
‘debug’ code is that it might contain links between each line of the source code and 
its respective machine code address. Optimizing compilers, on the other hand, tend 
to produce output where entire lines of source code can be optimized away and thus 
not even be present in the resulting machine code. Reverse engineers can encounter 
either version, simply because some developers turn on the compiler's optimization 
flags and others do not. Because ofthis, we'll try to work on examples of both debug 
and release versions of the code featured in this book, wherever possible. 


Sometimes some pretty ancient compilers are used in this book, in order to get the 
shortest (or simplest) possible code snippet. 


1.2 Some basics 


1.2.1 A short introduction to the CPU 


The CPU is the device that executes the machine code a program consists of. 
A short glossary: 


Instruction : A primitive CPU command. The simplest examples include: moving 
data between registers, working with memory, primitive arithmetic operations. 
As a rule, each CPU has its own instruction set architecture (ISA). 


Machine code : Code that the CPU directly processes. Each instruction is usually 
encoded by several bytes. 


Assembly language : Mnemonic code and some extensions, like macros, that are 
intended to make a programmer's life easier. 


CPU register : Each CPU has a fixed set of general purpose registers (GPR?). = 8 
in x86, « 16 in x86-64, and also « 16 in ARM. The easiest way to understand a 
register is to think of it as an untyped temporary variable. Imagine if you were 
working with a high-level PL and could only use eight 32-bit (or 64-bit) variables. 
Yet a lot can be done using just these! 


One might wonder why there needs to be a difference between machine code and 
a PL. The answer lies in the fact that humans and CPUs are not alike—it is much 
easier for humans to use a high-level PL like C/C++, Java, or Python, but it is easier 
for a CPU to use a much lower level of abstraction. Perhaps it would be possible to 
invent a CPU that can execute high-level PL code, but it would be many times more 
complex than the CPUs we know of today. In a similar fashion, it is very inconvenient 
for humans to write in assembly language, due to it being so low-level and difficult 


?General Purpose Registers 
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to write in without making a huge number of annoying mistakes. The program that 
converts the high-level PL code into assembly is called a compiler. ?. 


A couple of words about different ISAs 


The x86 ISA has always had variable-length instructions, so when the 64-bit era 
came, the x64 extensions did not impact the ISA very significantly. In fact, the x86 
ISA still contains a lot of instructions that first appeared in 16-bit 8086 CPU, yet are 
still found in the CPUs of today. ARM is a RISC* CPU designed with constant-length 
instructions in mind, which had some advantages in the past. In the very begin- 
ning, all ARM instructions were encoded in 4 bytes?. This is now referred to as "ARM 
mode". Then they realized it wasn't as frugal as they first imagined. In fact, the most 
common CPU instructions? in real world applications can be encoded using less infor- 
mation. They therefore added another ISA, called Thumb, in which each instruction 
was encoded in just 2 bytes. This is now referred to as "Thumb mode". However, not 
all ARM instructions can be encoded in just 2 bytes, so the Thumb instruction set is 
somewhat limited. It is worth noting that code compiled for ARM mode and Thumb 
mode can coexist within one single program. The ARM creators thought Thumb could 
be extended, giving rise to Thumb-2, which appeared in ARMv7. Thumb-2 still uses 
2-byte instructions, but has some new instructions which have the size of 4 bytes. 
There is a common misconception that Thumb-2 is a mix of ARM and Thumb. This 
is incorrect. Rather, Thumb-2 was extended to fully support all processor features 
so it could compete with ARM mode—a goal that was clearly achieved, as the ma- 
jority of applications for iPod/iPhone/iPad are compiled for the Thumb-2 instruction 
set. (Though, admittedly, this is largely due to the fact that Xcode does this by de- 
fault). Later the 64-bit ARM came out. This ISA has 4-byte instructions, and lacked 
the need of any additional Thumb mode. However, the 64-bit requirements affected 
the ISA, resulting in us now having three ARM instruction sets: ARM mode, Thumb 
mode (including Thumb-2) and ARM64. These ISAs intersect partially, but it can be 
said that they are different ISAs, rather than variations of the same one. Therefore, 
we will try to add fragments of code in all three ARM ISAs in this book. There are, by 
the way, many other RISC ISAs with fixed length 32-bit instructions, such as MIPS, 
PowerPC and Alpha AXP. 


3Qld-school Russian literature also uses the term "translator". 

^Reduced Instruction Set Computing 

5Fixed-length instructions are handy because one can calculate the next (or previous) instruction ad- 
dress without effort. This feature will be discussed in the switch() operator (1.21.2 on page 217) section. 


$e.g. MOV/PUSH/CALL/Jcc 
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1.2.2 Numeral Systems 


Nowadays octal numbers seem to be used 
for exactly one purpose—file permissions on 
POSIX systems—but hexadecimal numbers 
are widely used to emphasize the bit pattern 
of a number over its numeric value. 


Alan A. A. Donovan, Brian W. Kernighan — 
The Go Programming Language 


Humans have become accustomed to a decimal numeral system, probably because 
almost everyone has 10 fingers. Nevertheless, the number "10" has no significant 
meaning in science and mathematics. The natural numeral system in digital elec- 
tronics is binary: O is for an absence of current in the wire, and 1 for presence. 10 
in binary is 2 in decimal, 100 in binary is 4 in decimal, and so on. 


If the numeral system has 10 digits, it has a radix (or base) of 10. The binary numeral 
system has a radix of 2. 


Important things to recall: 


1) A number is a number, while a digit is a term from writing systems, and is usually 
one character 


2) The value of a number does not change when converted to another radix; only 
the writing notation for that value has changed. 


1.2.3 Converting From One Radix To Another 


Positional notation is used in almost every numerical system. This means that a digit 
has weight relative to where it is placed inside of the larger number. If 2 is placed 
at the rightmost place, it's 2, but if it's placed one digit before rightmost, it's 20. 


What does 1234 stand for? 
10?-1-- 10?-2-- 101 -3-- 1-4 = 1234 or 1000-1 - 100-2 4- 10-3-- 4 = 1234 


It’s the same story for binary numbers, but the base is 2 instead of 10. What does 
0b101011 stand for? 


25.1 -2*.0-c23.1-- 22.0 21.14-29.12 43 or 32-14+16-04+8-144-042-141=43 


There is such a thing as non-positional notation, such as the Roman numeral system. 
7, Perhaps, humankind switched to positional notation because it's easier to do basic 
operations (addition, multiplication, etc.) on paper by hand. 


Binary numbers can be added, subtracted and so on in the very same as taught in 
schools, but only 2 digits are available. 


Binary numbers are bulky when represented in source code and dumps, so that is 
where the hexadecimal numeral system can be useful. A hexadecimal radix uses 
the digits 0..9, and also 6 Latin characters: A..F. Each hexadecimal digit takes 4 bits 


7 About numeric system evolution, see [Donald E. Knuth, The Art of Computer Programming, Volume 2, 
3rd ed., (1997), 195-213.] 
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or 4 binary digits, so it's very easy to convert from binary number to hexadecimal 
and back, even manually, in one's mind. 


hexadecimal | binary | decimal 
0 0000 |0 
1 0001 | 1 
2 0010 | 2 
3 0011 | 3 
4 0100 | 4 
5 0101 |5 
6 0110 | 6 
7 0111 7 
8 1000 | 8 
9 1001 | 9 
A 1010 | 10 
B 1011 11 
C 1100 |12 
D 1101 13 
E 1110 14 
F 1111 15 


How can one tell which radix is being used in a specific instance? 


Decimal numbers are usually written as is, i.e., 1234. Some assemblers allow an 
identifier on decimal radix numbers, in which the number would be written with a 
"d" suffix: 1234d. 


Binary numbers are sometimes prepended with the "Ob" prefix: 05100110111 (GCC? 
has a non-standard language extension for this?). There is also another way: using 
a "b" suffix, for example: 100110111b. This book tries to use the "Ob" prefix consis- 
tently throughout the book for binary numbers. 


Hexadecimal numbers are prepended with "Ox" prefix in C/C++ and other PLs: 0x1234ABCD. 
Alternatively, they are given a "h" suffix: 1234ABCDh. This is common way of rep- 
resenting them in assemblers and debuggers. In this convention, if the number is 
started with a Latin (A..F) digit, a O is added at the beginning: OABCDEFh. There was 

also convention that was popular in 8-bit home computers era, using $ prefix, like 
$ABCD. The book will try to stick to "Ox" prefix throughout the book for hexadecimal 
numbers. 


Should one learn to convert numbers mentally? A table of 1-digit hexadecimal num- 
bers can easily be memorized. As for larger numbers, it's probably not worth tor- 
menting yourself. 


Perhaps the most visible hexadecimal numbers are in URL!°s. This is the way that 
non-Latin characters are encoded. For example: https://en.wiktionary.org/ 
wiki/na%C3%AFvet%C3%A9 is the URL of Wiktionary article about “naïveté” word. 


8GNU Compiler Collection 
9https://gcc.gnu.org/onlinedocs/gcc/Binary- constants.html 
10Uniform Resource Locator 
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Octal Radix 


Another numeral system heavily used in the past of computer programming is octal. 
In octal there are 8 digits (0..7), and each is mapped to 3 bits, so it's easy to convert 
numbers back and forth. It has been superseded by the hexadecimal system almost 
everywhere, but, surprisingly, there is a *NIX utility, used often by many people, 
which takes octal numbers as argument: chmod. 


As many *NIX users know, chmod argument can be a number of 3 digits. The first digit 
represents the rights of the owner of the file (read, write and/or execute), the second 
is the rights for the group to which the file belongs, and the third is for everyone else. 
Each digit that chmod takes can be represented in binary form: 


decimal | binary | meaning 
7 111 rwx 

6 110 rw- 

5 101 r-x 

4 100 r-- 

3 011 -WX 

2 010 -W- 

1 001 --X 

0 000 --- 


So each bit is mapped to a flag: read/write/execute. 


The importance of chmod here is that the whole number in argument can be repre- 
sented as octal number. Let’s take, for example, 644. When you run chmod 644 
file, you set read/write permissions for owner, read permissions for group and 
again, read permissions for everyone else. If we convert the octal number 644 to 
binary, it would be 110100100, or, in groups of 3 bits, 110 100 100. 


Now we see that each triplet describe permissions for owner/group/others: first is 
rw-, second is r-- and third is r--. 


The octal numeral system was also popular on old computers like PDP-8, because 
word there could be 12, 24 or 36 bits, and these numbers are all divisible by 3, so 
the octal system was natural in that environment. Nowadays, all popular computers 
employ word/address sizes of 16, 32 or 64 bits, and these numbers are all divisible 
by 4, so the hexadecimal system is more natural there. 


The octal numeral system is supported by all standard C/C++ compilers. This is 
a source of confusion sometimes, because octal numbers are encoded with a zero 
prepended, for example, 0377 is 255. Sometimes, you might make a typo and write 
"09" instead of 9, and the compiler would report an error. GCC might report some- 
thing like this: 

error: invalid digit "9" in octal constant. 

Also, the octal system is somewhat popular in Java. When the IDA shows Java strings 


with non-printable characters, they are encoded in the octal system instead of hex- 
adecimal. The JAD Java decompiler behaves the same way. 
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Divisibility 


When you see a decimal number like 120, you can quickly deduce that it's divisible 
by 10, because the last digit is zero. In the same way, 123400 is divisible by 100, 
because the two last digits are zeros. 


Likewise, the hexadecimal number 0x1230 is divisible by 0x10 (or 16), 0x123000 is 
divisible by 0x1000 (or 4096), etc. 


The binary number 0b1000101000 is divisible by 061000 (8), etc. 


This property can often be used to quickly realize if an address or a size of some 
block in memory is padded to some boundary. For example, sections in PE! files 
are almost always started at addresses ending with 3 hexadecimal zeros: 0x41000, 
0x10001000, etc. The reason behind this is the fact that almost all PE sections are 
padded to a boundary of 0x1000 (4096) bytes. 


Multi-Precision Arithmetic and Radix 


Multi-precision arithmetic can use huge numbers, and each one may be stored in 
several bytes. For example, RSA keys, both public and private, span up to 4096 bits, 
and maybe even more. 


In [Donald E. Knuth, The Art of Computer Programming, Volume 2, 3rd ed., (1997), 
265] we find the following idea: when you store a multi-precision number in several 
bytes, the whole number can be represented as having a radix of 2° = 256, and each 
digit goes to the corresponding byte. Likewise, if you store a multi-precision number 
in several 32-bit integer values, each digit goes to each 32-bit slot, and you may 
think about this number as stored in radix of 2??. 


How to Pronounce Non-Decimal Numbers 


Numbers in a non-decimal base are usually pronounced by digit by digit: "one-zero- 


zero-one-one-...". Words like "ten" and "thousand" are usually not pronounced, to 


prevent confusion with the decimal base system. 


Floating point numbers 


To distinguish floating point numbers from integers, they are usually written with ".0" 
at the end, like 0.0, 123.0, etc. 


1.3 An Empty Function 


The simplest possible function is arguably one that does nothing: 


Listing 1.1: C/C++ Code 


void f() 
1 


11Portable Executable 
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return; 


ur 


Let's compile it! 


1.3.1 x86 
Here's what both the GCC and MSVC compilers produce on the x86 platform: 
Listing 1.2: Optimizing GCC/MSVC (assembly output) 


ret 


There is just one instruction: RET, which returns execution to the caller. 


1.3.2 ARM 

Listing 1.3: Optimizing Keil 6/2013 (ARM mode) assembly output 
f PROC 

BX lr 

ENDP 


The return address is not saved on the local stack in the ARM ISA, but rather in the 
link register, so the BX LR instruction causes execution to jump to that address— 
effectively returning execution to the caller. 


1.3.3 MIPS 


There are two naming conventions used in the world of MIPS when naming registers: 
by number (from $0 to $31) or by pseudo name ($VO, $A0, etc.). 


The GCC assembly output below lists registers by number: 


Listing 1.4: Optimizing GCC 4.4.5 (assembly output) 


j $31 
nop 


... While IDA?? does it by pseudo name: 


Listing 1.5: Optimizing GCC 4.4.5 (IDA) 


j $ra 
nop 


The first instruction is the jump instruction (J or JR) which returns the execution flow 
to the caller, jumping to the address in the $31 (or $RA) register. 


12 Interactive Disassembler and Debugger developed by Hex-Rays 
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This is the register analogous to LRI? in ARM. 


The second instruction is NOP!^, which does nothing. We can ignore it for now. 


A Note About MIPS Instructions and Register Names 


Register and instruction names in the world of MIPS are traditionally written in low- 
ercase. However, for the sake of consistency, this book will stick to using uppercase 
letters, as it is the convention followed by all the other ISAs featured in this book. 


1.3.4 Empty Functions in Practice 


Despite the fact empty functions seem useless, they are quite frequent in low-level 
code. 


First of all, they are quite popular in debugging functions, like this one: 
Listing 1.6: C/C++ code 


void dbg print (const char *fmt, ...) 


{ 
#ifdef DEBUG 
// open log file 
// write to log file 
// close log file 
#endif 
$; 


void some function() 
t 


dbg print ("we did something Nn"); 


ur 


In a non-debug build (as in a "release"), DEBUG is not defined, so the dbg print() 
function, despite still being called during execution, will be empty. 


Similarly, a popular method of software protection is to make one build for legal cus- 
tomers, and another demo build. A demo build can lack of some important functions, 
as with this example: 


Listing 1.7: C/C++ code 


void save file () 


{ 
#ifndef DEMO 
// a real saving code 
#endif 
Hh 


131 ink Register 
1^No Operation 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


10 
The save file() function could be called when the user clicks File->Save on the 
menu. The demo version might be delivered with this menu item disabled, but even 
if a software cracker would enable it, only an empty function with no useful code will 
be called. 


IDA marks such functions with names like nullsub 00, nullsub 01, etc. 


1.4 Returning Values 


Another simple function is the one that simply returns a constant value: 


Listing 1.8: C/C++ Code 


int f() 
{ 


3 


return 123; 


Let’s compile it. 


1.4.1 x86 


Here’s what both the GCC and MSVC compilers produce (with optimization) on the 
x86 platform: 


Listing 1.9: Optimizing GCC/MSVC (assembly output) 


mov eax, 123 
ret 


There are just two instructions: the first places the value 123 into the EAX register, 
which is used by convention for storing the return value, and the second one is RET, 
which returns execution to the caller. 


The caller will take the result from the EAX register. 


1.4.2 ARM 


There are a few differences on the ARM platform: 


Listing 1.10: Optimizing Keil 6/2013 (ARM mode) ASM Output 


f PROC 
MOV r0,#0x7b ; 123 
BX lr 
ENDP 


ARM uses the register RO for returning the results of functions, so 123 is copied into 
RO. 
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It is worth noting that MOV is a misleading name for the instruction in both the x86 
and ARM ISAs. 


The data is not in fact moved, but copied. 


1.4.3 MIPS 
The GCC assembly output below lists registers by number: 


Listing 1.11: Optimizing GCC 4.4.5 (assembly output) 


j $31 
li $2,123 # Ox7b 


...while IDA does it by their pseudo names: 


Listing 1.12: Optimizing GCC 4.4.5 (IDA) 


jr $ra 
li $v0, Ox7B 


The $2 (or $VO) register is used to store the function's return value. LI stands for 
"Load Immediate" and is the MIPS equivalent to MOV. 


The other instruction is the jump instruction (J or JR) which returns the execution flow 
to the caller. 


You might be wondering why the positions of the load instruction (LI) and the jump 
instruction (J or JR) are swapped. This is due to a RISC feature called "branch delay 
slot". 


The reason this happens is a quirk in the architecture of some RISC ISAs and isn't im- 
portant for our purposes—we must simply keep in mind that in MIPS, the instruction 
following a jump or branch instruction is executed before the jump/branch instruc- 
tion itself. 


As a consequence, branch instructions always swap places with the instruction exe- 
cuted immediately preceding it. 


In practice, functions which merely return 1 (true) or O (false) are very common. 


The smallest ever of the standard UNIX utilities, /bin/true and /bin/false return 0 and 1 
respectively, as an exit code. (Zero as an exit code usually means success, non-zero 
means error.) 


1.5 Hello, world! 


Let's use the famous example from the book [Brian W. Kernighan, Dennis M. Ritchie, 
The C Programming Language, 2ed, (1988)]: 


Listing 1.13: C/C++ Code 


#include <stdio.h> 
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int main() 


printf("hello, world\n"); 


return 0; 
} 
1.5.1 x86 
MSVC 


Let’s compile it in MSVC 2010: 


cl 1.cpp /Fal.asm 


(The /Fa option instructs the compiler to generate an assembly listing file) 


Listing 1.14: MSVC 2010 


CONST SEGMENT 

$5G3830 DB ‘hello, world', OAH, 00H 
CONST ENDS 

PUBLIC _main 

EXTRN _printf:PROC 

; Function compile flags: /Odtp 

TEXT | SEGMENT 


_main PROC 
push ebp 
mov ebp, esp 
push OFFSET $5G3830 
call _printf 
add esp, 4 
xor eax, eax 
pop ebp 
ret 0 

main  ENDP 

TEXT ENDS 


MSVC produces assembly listings in Intel-syntax. The differences between Intel- 
syntax and AT&T-syntax will be discussed in 1.5.1 on page 15. 


The compiler generated the file, 1.0bj, which is to be linked into 1.exe. In our case, 
the file contains two segments: CONST (for data constants) and TEXT (for code). 


The string hello, world in C/C++ has type const char[][Bjarne Stroustrup, The 
C++ Programming Language, 4th Edition, (2013)p176, 7.3.2], but it does not have 
its own name. The compiler needs to deal with the string somehow, so it defines the 
internal name $S5G3830 for it. 


That is why the example may be rewritten as follows: 


#include <stdio.h> 


const char $5G3830[]="hello, world\n"; 
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int main() 

1 
printf($SG3830); 
return 0; 

} 


Let’s go back to the assembly listing. As we can see, the string is terminated by a 
zero byte, which is standard for C/C++ strings. More about C/C++ strings: 5.4.1 on 
page 895. 


In the code segment, _TEXT, there is only one function so far: main(). The func- 
tion main() starts with prologue code and ends with epilogue code (like almost any 
function) 1>. 


After the function prologue we see the call to the printf() function: 
CALL printf. Before the call, a string address (or a pointer to it) containing our 
greeting is placed on the stack with the help of the PUSH instruction. 


When the printf() function returns the control to the main() function, the string 
address (or a pointer to it) is still on the stack. Since we do not need it anymore, the 
stack pointer (the ESP register) needs to be corrected. 


ADD ESP, 4 means add 4 to the ESP register value. 


Why 4? Since this is a 32-bit program, we need exactly 4 bytes for address pass- 
ing through the stack. If it was x64 code we would need 8 bytes. ADD ESP, 4 is 
effectively equivalent to POP register but without using any register?*?. 


For the same purpose, some compilers (like the Intel C++ Compiler) may emit POP 
ECX instead of ADD (e.g., such a pattern can be observed in the Oracle RDBMS code 
as itis compiled with the Intel C++ compiler). This instruction has almost the same 
effect but the ECX register contents will be overwritten. The Intel C++ compiler 
supposedly uses POP ECX since this instruction's opcode is shorter than ADD ESP, x 
(1 byte for POP against 3 for ADD). 


Here is an example of using POP instead of ADD from Oracle RDBMS: 


Listing 1.15: Oracle RDBMS 10.2 Linux (app.o file) 


.text:0800029A push ebx 
.text:0800029B call qksfroChild 
.text:080002A0 pop ecx 


However, MSVC can do the same. 


Listing 1.16: MineSweeper from Windows 7 32-bit 


.text:0102106F push 0 
.text:01021071 call ds:time 
.text:01021077 pop ecx 


15You can read more about it in the section about function prologues and epilogues (1.6 on page 39). 
16CPU flags, however, are modified 
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After calling printf(), the original C/C++ code contains the statement return 0 — 
return O as the result of the main() function. 


In the generated code this is implemented by the instruction XOR EAX, EAX. 


XOR is in fact just “eXclusive OR”*” but the compilers often use it instead of MOV EAX, 
0—again because it is a slightly shorter opcode (2 bytes for XOR against 5 for MOV). 


Some compilers emit SUB EAX, EAX, which means SUBtract the value in the EAX 
from the value in EAX. That in any case will results in zero. 


The last instruction RET returns the control to the caller. Usually, this is C/C++ CRT1? 
code which in turn returns control to the OS. 


GCC 


Now let's try to compile the same C/C++ code in the GCC 4.4.1 compiler in Linux: 
gcc l.c -o 1. Next, with the assistance of the IDA disassembler, let's see how the 
main() function was created. IDA, like MSVC, uses Intel-syntax??. 


Listing 1.17: code in IDA 


main proc near 
var 10 = dword ptr -10h 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 10h 
mov eax, offset aHelloWorld ; "hello, world^n" 
mov [esp-10h-var 10], eax 
call _printf 
mov eax, 0 
leave 
retn 
main endp 


The result is almost the same. The address of the hello, world string (stored in 
the data segment) is loaded in the EAX register first, and then saved onto the stack. 
In addition, the function prologue has AND ESP, OFFFFFFFOh —this instruction aligns 
the ESP register value on a 16-byte boundary. This results in all values in the stack 
being aligned the same way (The CPU performs better if the values it is dealing with 
are located in memory at addresses aligned on a 4-byte or 16-byte boundary). 


SUB ESP, 10h allocates 16 bytes on the stack. Although, as we can see hereafter, 
only 4 are necessary here. 


This is because the size of the allocated stack is also aligned on a 16-byte boundary. 


V Wikipedia 
18C Runtime library 


19We could also have GCC produce assembly listings in Intel-syntax by applying the options -S 
-masm-intel. 
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The string address (or a pointer to the string) is then stored directly onto the stack 
without using the PUSH instruction. var 10 —is a local variable and is also an argu- 
ment for printf(). Read about it below. 


Then the printf() function is called. 


Unlike MSVC, when GCC is compiling without optimization turned on, it emits MOV 
EAX, 0 instead of a shorter opcode. 


The last instruction, LEAVE —is the equivalent of the MOV ESP, EBP and POP EBP 
instruction pair —in other words, this instruction sets the stack pointer (ESP) back 
and restores the EBP register to its initial state. This is necessary since we modified 
these register values (ESP and EBP) at the beginning of the function (by executing 
MOV EBP, ESP/AND ESP, ..). 


GCC: AT&T syntax 


Let's see how this can be represented in assembly language AT&T syntax. This 
syntax is much more popular in the UNIX-world. 


Listing 1.18: let's compile in GCC 4.7.3 


gcc -S 1 1.c 


We get this: 
Listing 1.19: GCC 4.7.3 


„file "doc" 


. section . rodata 
.LC0: 
.string "hello, worldin" 
.text 
.globl main 
.type main, @function 
main: 
.LFBO: 
.cfi_startproc 
pushl %ebp 
.Cfi def cfa offset 8 
.Cfi offset 5, -8 
movl “esp, “ebp 
.Cfi def cfa register 5 
andl $-16, %esp 
subl $16, %esp 
movl $.LCO, (%esp) 
call printf 
movl $0, %eax 
leave 
.Cfi restore 5 
.Cfi def cfa4, 4 
ret 
.Cfi endproc 
.LFEO: 
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.Size main, .-main 
.ident "GCC: (Ubuntu/Linaro 4.7.3-lubuntul) 4.7.3" 
. section .note.GNU-stack,"",@progbits 


The listing contains many macros (the parts that begin with a dot). These are not 
interesting for us at the moment. 


For now, for the sake of simplicity, we can ignore them (except the .string macro 
which encodes a null-terminated character sequence just like a C-string). Then we'll 
see this 2°: 


Listing 1.20: GCC 4.7.3 


.LC0: 
.string "hello, world\n" 
main: 
pushl %ebp 
movl “esp, “ebp 
andl $-16, %esp 
subl $16, %esp 
movl $.LCO, (%esp) 
call printf 
movl $0, %eax 
leave 
ret 


Some of the major differences between Intel and AT&T syntax are: 
* Source and destination operands are written in opposite order. 
In Intel-syntax: «instruction» «destination operand> «source operand>. 
In AT&T syntax: «instruction «source operand> «destination operand>. 


Here is an easy way to memorize the difference: when you deal with Intel- 
syntax, you can imagine that there is an equality sign (2) between operands 
and when you deal with AT&T-syntax imagine there is a right arrow (>) ?!. 


* AT&T: Before register names, a percent sign must be written (96) and before 
numbers a dollar sign ($). Parentheses are used instead of brackets. 


* AT&T: A suffix is added to instructions to define the operand size: 
- q — quad (64 bits) 
- |— long (32 bits) 
- w — word (16 bits) 
- b — byte (8 bits) 


20This GCC option can be used to eliminate "unnecessary" macros: -fno-asynchronous-unwind-tables 

21By the way, in some C standard functions (e.g., memcpy(), strcpy()) the arguments are listed in the 
same way as in Intel-syntax: first the pointer to the destination memory block, and then the pointer to 
the source memory block. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


17 
To go back to the compiled result: it is almost identical to what was displayed by IDA. 
There is one subtle difference: OFFFFFFFOh is presented as $- 16. It's the same thing: 
16 in the decimal system is 0x10 in hexadecimal. -0x10 is equal to OxFFFFFFFO (for 
a 32-bit data type). 


One more thing: the return value is set to O by using the usual MOV, not XOR. MOV just 
loads a value to a register. Its name is a misnomer (as the data is not moved but 
rather copied). In other architectures, this instruction is named "LOAD" or "STORE" 
or something similar. 


String patching (Win32) 


We can easily find the "hello, world" string in the executable file using Hiew: 


Hiew: hw  spanish.exe 


)00 |Hiew 8.02 


_PE+. 00000001" 4000 


Figure 1.1: Hiew 


And we can try to translate our message into Spanish: 


p\hw_spanish.exe  BFWO EDITMODE PE+ 0000000070000120D |Hiew 8.02. 


Figure 1.2: Hiew 


The Spanish text is one byte shorter than English, so we also added the 0x0A byte 
at the end (Xn) with a zero byte. 


It works. 


What if we want to insert a longer message? There are some zero bytes after original 
English text. It's hard to say if they can be overwritten: they may be used somewhere 
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in CRT code, or maybe not. Anyway, only overwrite them if you really know what 
you're doing. 


String patching (Linux x64) 
Let's try to patch a Linux x64 executable using rada.re: 


Listing 1.21: rada.re session 


dennis@bigbox ~/tmp % gcc hw.c 


dennis@bigbox ~/tmp % radare2 a.out 
-- SHALL WE PLAY A GAME? 
[0x00400430]> / hello 
Searching 5 bytes from 0x00400000 to 0x00601040: 68 65 6c 6c 6f 
Searching 5 bytes in [0x400000-0x601040] 
hits: 1 
0x004005c4 hit0_0 .HHhello, world;0. 


[0x00400430]> s 0x004005c4 


[0x004005c4]» px 
- offset - 01 23 45 67 89 AB CD EF 6123456789ABCDEF 
0x004005c4 6865 6c6c 6f2c 2077 6f72 6c64 0000 0000 hello, world.... 
0x004005d4 011b 033b 3000 0000 0500 0000 Icfe ffff ...;0........... 
0x004005e4 7c00 0000 5cfe ffff 4c00 0000 52ff ffff |...\...L...R... 
0x004005f4 a400 0000 6cff ffff c400 0000 deff ffff ....l........... 
0x00400604 OcO1 0000 1400 0000 0000 0000 017a 5200 ............. zR. 
0x00400614 0178 1001 1b0c 0708 9001 0710 1400 0000 .x.............. 
0x00400624 1c00 0000 08fe ffff 2a00 0000 0000 0000 ........ MUN 
0x00400634 0000 0000 1400 0000 0000 0000 017a 5200 ............. zR. 
0x00400644 0178 1001 1b0c 0708 9001 0000 2400 0000 .x.......... $... 
0x00400654 1c00 0000 98fd ffff 3000 0000 000e 1046 ........ NEM F 
0x00400664 0el8 4a0f 0b77 0880 003f 1a3b 2a33 2422 ..J..w...?.;*3$" 
0x00400674 0000 0000 1c00 0000 4400 0000 a6fe ffff ........ D... 
0x00400684 1500 0000 0041 0e10 8602 430d 0650 0c07 ..... O NON 
0x00400694 0800 0000 4400 0000 6400 0000 a0fe ffff ....D...d....... 
0x004006a4 6500 0000 0042 0e10 8f02 420e 188e 0345 e....B....B....E 
0x004006b4 0e20 8d04 420e 288c 0548 0e30 8606 480e . ..B.(..H.0..H. 


[0x004005c4]> oo+ 
File a.out reopened in read-write mode 


[0x004005c4]> w hola, mundo\x00 
[0x004005c4]> q 


dennis@bigbox -/tmp % ./a.out 
hola, mundo 


Here's what's going on: | searched for the “hello” string using the / command, then 
| set the cursor (seek, in rada.re terms) to that address. Then | want to be sure that 
this is really that place: px dumps bytes there. 00+ switches rada.re to read-write 
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mode. w writes an ASCII string at the current seek. Note the 100 at the end—this is 
a zero byte. q quits. 


This is a real story of software cracking 


An image processing software, when not registered, added watermarks, like “This im- 
age was processed by evaluation version of [software name]", across a picture. We 
tried at random: we found that string in the executable file and put spaces instead of 
it. Watermarks disappeared. Technically speaking, they continued to appear. With 
the help of Qt functions, the watermark was still added to the resulting image. But 
adding spaces didn't alter the image itself... 


Software localization of MS-DOS era 


This method was a common way to translate MS-DOS software to Russian language 
back to 1980's and 1990's. This technique is available even for those who are not 
aware of machine code and executable file formats. The new string shouldn't be 
bigger than the old one, because there's a risk of overwriting another value or code 
there. Russian words and sentences are usually slightly longer than its English coun- 
terparts, so that is why localized software has a lot of weird acronyms and hardly 
readable abbreviations. 


Figure 1.3: Localized Norton Commander 5.51 


Perhaps this also happened to other languages during that era, in other countries. 


As for Delphi strings, the string's size must also be corrected, if needed. 


1.5.2 x86-64 
MSVC: x86-64 
Let's also try 64-bit MSVC: 
Listing 1.22: MSVC 2012 x64 


$5G2989 DB 'hello, world', 0AH, 00H 
main PROC 
sub rsp, 40 
lea rcx, OFFSET FLAT:$5G2989 
call printf 
xor eax, eax 
add rsp, 40 
ret 0 
main ENDP 
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In x86-64, all registers were extended to 64-bit, and now their names have an R- 
prefix. In order to use the stack less often (in other words, to access external memo- 
ry/cache less often), there is a popular way to pass function arguments via registers 
(fastcall) 6.1.3 on page 934. l.e., a part of the function's arguments are passed in 
registers, and the rest—via the stack. In Win64, 4 function arguments are passed 
in the RCX, RDX, R8, and R9 registers. That is what we see here: a pointer to the 
string for printf() is now passed not in the stack, but rather in the RCX register. 
The pointers are 64-bit now, so they are passed in the 64-bit registers (which have 
the R- prefix). However, for backward compatibility, it is still possible to access the 
32-bit parts, using the E- prefix. This is how the RAX/EAX/AX/AL register looks like in 
x86-64: 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RAX*64 


EAX 


AX 
AH | AL 


The main() function returns an int-typed value, which in C/C++ is still 32-bit, for bet- 
ter backward compatibility and portability, so that is why the EAX register is cleared 
at the function end (i.e., the 32-bit part of the register) instead of with RAX. There are 
also 40 bytes allocated in the local stack. This is called the "shadow space", which 
we'll talk about later: 1.14.2 on page 129. 


GCC: x86-64 
Let's also try GCC in 64-bit Linux: 
Listing 1.23: GCC 4.4.6 x64 


.string "hello, world\n" 


main: 
sub rsp, 8 
mov edi, OFFSET FLAT:.LCO ; "hello, world\n" 
xor eax, eax ; number of vector registers passed 
call printf 
xor eax, eax 
add rsp, 8 
ret 


Linux, *BSD and Mac OS X also use a method to pass function arguments in registers. 
[Michael Matz, Jan Hubicka, Andreas Jaeger, Mark Mitchell, System V Application 
Binary Interface. AMD64 Architecture Processor Supplement, (2013)] ??. 


The first 6 arguments are passed in the RDI, RSI, RDX, RCX, R8, and R9 registers, and 
the rest—via the stack. 


So the pointer to the string is passed in EDI (the 32-bit part of the register). Why 
doesn't it use the 64-bit part, RDI? 


22Also available as  https://software.intel.com/sites/default/files/article/402129/ 
mpx- Linux64- abi. pdf 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


21 
It is important to keep in mind that all MOV instructions in 64-bit mode that write 
something into the lower 32-bit register part also clear the higher 32-bits (as stated 
in Intel manuals: 12.1.4 on page 1282). 
l.e., the MOV EAX, 011223344h writes a value into RAX correctly, since the higher 
bits will be cleared. 


If we open the compiled object file (.o), we can also see all the instructions’ opcodes 
23: 


Listing 1.24: GCC 4.4.6 x64 


.text:00000000004004D0 main proc near 

.text:00000000004004D0 48 83 EC 08 sub rsp, 8 

.text:00000000004004D4 BF E8 05 40 00 mov edi, offset format ; "hello, 
world Xn" 

text: 00000000004004D9 31 CO xor eax, eax 

.text:00000000004004DB E8 D8 FE FF FF call | printf 

.text:00000000004004E0 31 CO xor eax, eax 

.text:00000000004004E2 48 83 C4 08 add rsp, 8 

.text:00000000004004E6 C3 retn 

.text:00000000004004E6 main endp 


As we can see, the instruction that writes into EDI at 0x4004D4 occupies 5 bytes. 
The same instruction writing a 64-bit value into RDI occupies 7 bytes. Apparently, 
GCC is trying to save some space. Besides, it can be sure that the data segment 
containing the string will not be allocated at the addresses higher than 4GiB. 


We also see that the EAX register has been cleared before the printf () function call. 
This is done because according to ABI?* standard mentioned above, the number of 
used vector registers is to be passed in EAX in *NIX systems on x86-64. 


Address patching (Win64) 


If our example was compiled in MSVC 2013 using /MD switch (meaning a smaller 
executable due to MSVCR*.DLL file linkage), the main() function comes first, and 
can be easily found: 


23This must be enabled in Options > Disassembly > Number of opcode bytes 
?^Application Binary Interface 
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Figure 1.4: Hiew 


As an experiment, we can increment address by 1: 
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‘ello, v 


Figure 1.5: Hiew 


Hiew shows "ello, world". And when we run the patched executable, this very string 
is printed. 


Pick another string from binary image (Linux x64) 


The binary file l've got when | compile our example using GCC 5.4.0 on Linux x64 box 
has many other text strings. They are mostly imported function names and library 
names. 


Run objdump to get the contents of all sections of the compiled file: 


$ objdump -s a.out 
a.out: file format elf64-x86-64 


Contents of section .interp: 

400238 2f6c6962 36342f6c 642d6c69 6e75782d /lib64/ld-linux- 
400248 7838362d 36342e73 6f2e3200 x86-64.50.2. 
Contents of section .note.ABI-tag: 

400254 04000000 10000000 01000000 47465500 ............ GNU. 
400264 00000000 02000000 06000000 20000000 ............ 
Contents of section .note.gnu.build-id: 
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400274 04000000 14000000 03000000 474e5500 ............ GNU. 
400284 fe461178 5bb710b4 bbf2aca8 5eclec10 .F.x[....... sd 
400294 cf3f7ae4 .?Z. 


It's not a problem to pass address of the text string “/lib64/ld-linux-x86-64.s0.2” to 
printf(): 


#include <stdio.h> 


int main() 

{ 
printf (0x400238) ; 
return 0; 

} 


It's hard to believe, but this code prints the aforementioned string. 


If you would change the address to 0x400260, the "GNU" string would be printed. 
This address is true for my specific GCC version, GNU toolset, etc. On your system, 
the executable may be slightly different, and all addresses will also be different. Also, 
adding/removing code to/from this source code will probably shift all addresses back 
or forward. 


1.5.3 ARM 


For my experiments with ARM processors, several compilers were used: 
* Popular in the embedded area: Keil Release 6/2013. 
* Apple Xcode 4.6.3 IDE with the LLVM-GCC 4.2 compiler 2°. 


* GCC 4.9 (Linaro) (for ARM64), available as win32-executables at http://www. 
linaro.org/projects/armv8/. 


32-bit ARM code is used (including Thumb and Thumb-2 modes) in all cases in this 
book, if not mentioned otherwise. When we talk about 64-bit ARM here, we call it 
ARM64. 

Non-optimizing Keil 6/2013 (ARM mode) 


Let’s start by compiling our example in Keil: 


armcc.exe --arm --c90 -00 1.c 


The armcc compiler produces assembly listings in Intel-syntax, but it has high-level 
ARM-processor related macros ?5, but it is more important for us to see the instruc- 
tions "as is" so let's see the compiled result in IDA. 


25lt is indeed so: Apple Xcode 4.6.3 uses open-source GCC as front-end compiler and LLVM code 
generator 
26e.g. ARM mode lacks PUSH/POP instructions 
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Listing 1.25: Non-optimizing Keil 6/2013 (ARM mode) IDA 


.text:00000000 main 

.text:00000000 10 40 2D E9 STMFD SP! , {R4,LR} 

.text:00000004 1E OE 8F E2 ADR RO, aHelloWorld ; "hello, world" 

.text:00000008 15 19 00 EB BL — 2printf 

.text:0000000C 00 00 AO E3 MOV RO, 40 

.text:00000010 10 80 BD E8 LDMFD SP!, {R4,PC} 

.text:000001EC 68 65 6C 6C+aHelloWorld DCB "hello, world",0 ; DATA XREF: 
main+4 


In the example, we can easily see each instruction has a size of 4 bytes. Indeed, we 
compiled our code for ARM mode, not for Thumb. 


The very first instruction, STMFD SP!, {R4,LR}2’, works as an x86 PUSH instruction, 
writing the values of two registers (R4 and LR) into the stack. 


Indeed, in the output listing from the armcc compiler, for the sake of simplification, 
actually shows the PUSH {r4, lr} instruction. But that is not quite precise. The PUSH 
instruction is only available in Thumb mode. So, to make things less confusing, we're 
doing this in IDA. 


This instruction first decrements the SP?? so it points to the place in the stack that 
is free for new entries, then it saves the values of the R4 and LR registers at the 
address stored in the modified SP. 


This instruction (like the PUSH instruction in Thumb mode) is able to save several 
register values at once which can be very useful. By the way, this has no equivalent 
in x86. It can also be noted that the STMFD instruction is a generalization of the PUSH 
instruction (extending its features), since it can work with any register, not just with 
SP. In other words, STMFD may be used for storing a set of registers at the specified 
memory address. 


The ADR R0, aHelloWorld instruction adds or subtracts the value in the PC?? reg- 
ister to the offset where the hello, world string is located. How is the PC register 
used here, one might ask? This is called "position-independent code'?!. 


Such code can be executed at a non-fixed address in memory. In other words, this 
is PC-relative addressing. The ADR instruction takes into account the difference be- 
tween the address of this instruction and the address where the string is located. 
This difference (offset) is always to be the same, no matter at what address our 
code is loaded by the OS. That's why all we need is to add the address of the current 
instruction (from PC) in order to get the absolute memory address of our C-string. 


BL 2p rintf?? instruction calls the printf() function. Here's how this instruction 
works: 


* store the address following the BL instruction (0xC) into the LR; 


27STMFD28 

29stack pointer. SP/ESP/RSP in x86/x64. SP in ARM. 
30Program Counter. IP/EIP/RIP in x86/64. PC in ARM. 

31Read more about it in relevant section (6.4.1 on page 952) 
32Branch with Link 
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e then pass the control to printf() by writing its address into the PC register. 


When printf() finishes its execution it must have information about where it needs 
to return the control to. That's why each function passes control to the address 
stored in the LR register. 


That is a difference between "pure" RISC-processors like ARM and CISC??-processors 
like x86, where the return address is usually stored on the stack. Read more about 
this in next section (1.9 on page 40). 


By the way, an absolute 32-bit address or offset cannot be encoded in the 32-bit BL 
instruction because it only has space for 24 bits. As we may recall, all ARM-mode 
instructions have a size of 4 bytes (32 bits). Hence, they can only be located on 4- 
byte boundary addresses. This implies that the last 2 bits of the instruction address 
(which are always zero bits) may be omitted. In summary, we have 26 bits for offset 
encoding. This is enough to encode current. PC + x 32M. 


Next, the MOV RO, 40?^ instruction just writes O into the RO register. That's because 
our C-function returns 0 and the return value is to be placed in the RO register. 


The last instruction LDMFD SP!, R4,PC??.It loads values from the stack (or any other 
memory place) in order to save them into R4 and PC, and increments the stack 
pointer SP. It works like POP here. 

N.B. The very first instruction STMFD saved the R4 and LR registers pair on the stack, 
but R4 and PC are restored during the LDMFD execution. 


As we already know, the address of the place where each function must return control 
to is usually saved in the LR register. The very first instruction saves its value in the 
stack because the same register will be used by our main() function when calling 
printf(). In the function's end, this value can be written directly to the PC register, 
thus passing control to where our function has been called. 


Since main() is usually the primary function in C/C++, the control will be returned 
to the OS loader or to a point in a CRT, or something like that. 


All that allows omitting the BX LR instruction at the end of the function. 


DCB is an assembly language directive defining an array of bytes or ASCII strings, 
akin to the DB directive in the x86-assembly language. 


Non-optimizing Keil 6/2013 (Thumb mode) 


Let's compile the same example using Keil in Thumb mode: 


armcc.exe --thumb --c90 -00 1.c 


We are getting (in IDA): 
Listing 1.26: Non-optimizing Keil 6/2013 (Thumb mode) + IDA 


.text:00000000 main 


33Complex Instruction Set Computing 
34Meaning MOVe 
351 DMFD?6 is an inverse instruction of STMFD 
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.text:00000000 10 B5 PUSH (RA,LR) 

.text:00000002 CO AO ADR RO, aHelloWorld ; "hello, world" 

.text:00000004 06 FO 2E F9 BL _ 2printf 

.text:00000008 00 20 MOVS RO, 40 

.text:0000000A 10 BD POP {R4,PC} 

. text: 00000304 68 65 6C 6C+aHelloWorld DCB "hello, world",0 ; DATA XREF: 
main+2 


We can easily spot the 2-byte (16-bit) opcodes. This is, as was already noted, Thumb. 
The BL instruction, however, consists of two 16-bit instructions. This is because it is 
impossible to load an offset for the printf() function while using the small space 
in one 16-bit opcode. Therefore, the first 16-bit instruction loads the higher 10 bits 
of the offset and the second instruction loads the lower 11 bits of the offset. 


As was noted, all instructions in Thumb mode have a size of 2 bytes (or 16 bits). This 
implies it is impossible for a Thumb-instruction to be at an odd address whatsoever. 
Given the above, the last address bit may be omitted while encoding instructions. 


In summary, the BL Thumb-instruction can encode an address in current, PC + x 2M. 


As for the other instructions in the function: PUSH and POP work here just like the 
described STMFD/LDMFD only the SP register is not mentioned explicitly here. ADR 
works just like in the previous example. MOVS writes O into the RO register in order to 
return zero. 


Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Xcode 4.6.3 without optimization turned on produces a lot of redundant code so we'll 
study optimized output, where the instruction count is as small as possible, setting 
the compiler switch -03. 


Listing 1.27: Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


. text:000028C4 hello world 

. text:000028C4 80 40 2D E9  STMFD SP!, {R7,LR} 
_ text:000028C8 86 06 01 E3 MOV RO, #0x1686 
. text:000028CC OD 70 AQ El MOV R7, SP 

. text:000028D0 00 00 40 E3 MOVT RO, #0 

. text:000028D4 00 00 8F EO ADD RO, PC, RO 

. text:000028D8 C3 05 00 EB BL | puts 

. text:000028DC 00 00 AO E3 MOV RO, 40 

. text:000028E0 80 80 BD E8 . LDMFD SP!, {R7,PC} 


. Cstring:00003F62 48 65 6C 6C«aHelloWorld 0 DCB "Hello world!",0 


The instructions STMFD and LDMFD are already familiar to us. 


The MOV instruction just writes the number 0x1686 into the RO register. This is the 
offset pointing to the "Hello world!" string. 


The R7 register (as it is standardized in [iOS ABI Function Call Guide, (2010)]?’) is a 


37Also available as http: //developer.apple.com/library/ios/documentation/Xcode/Conceptual/ 
iPhoneOSABIReference/iPhoneOSABIReference.pdf 
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frame pointer. More on that below. 


The MOVT RO, #0 (MOVe Top) instruction writes O into higher 16 bits of the register. 
The issue here is that the generic MOV instruction in ARM mode may write only the 
lower 16 bits of the register. 


Keep in mind, all instruction opcodes in ARM mode are limited in size to 32 bits. Of 
course, this limitation is not related to moving data between registers. That's why 
an additional instruction MOVT exists for writing into the higher bits (from 16 to 31 
inclusive). Its usage here, however, is redundant because the MOV RO, #0x1686 
instruction above cleared the higher part of the register. This is supposedly a short- 
coming of the compiler. 


The ADD RO, PC, RO instruction adds the value in the PC to the value in the RO, to 
calculate the absolute address of the "Hello world!" string. As we already know, it 
is "position-independent code" so this correction is essential here. 


The BL instruction calls the puts() function instead of printf(). 


LLVM has replaced the first printf() call with puts(). Indeed: printf() with a sole 
argument is almost analogous to puts(). 


Almost, because the two functions are producing the same result only in case the 
string does not contain printf format identifiers starting with 96. In case it does, the 
effect of these two functions would be different 38. 


Why did the compiler replace the printf() with puts()? Presumably because 
puts() is faster ??. 


Because it just passes characters to stdout without comparing every one of them 
with the % symbol. 


Next, we see the familiar MOV RO, £0 instruction intended to set the RO register to 
0. 

Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 

By default Xcode 4.6.3 generates code for Thumb-2 in this manner: 


Listing 1.28: Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


_ text:00002B6C hello world 

. text:00002B6C 80 B5 PUSH {R7, LR} 

_ text:00002B6E 41 F2 D8 30 MOVW RO, #0x13D8 
_ text:00002B72 6F 46 MOV R7, SP 

_ text:00002B74 CO F2 00 00 MOVT.W RO, #0 

. text:00002B78 78 44 ADD RO, PC 

. text:00002B7A 01 FO 38 EA BLX puts 

. text:00002B7E 00 20 MOVS RO, #0 

_ text:00002B80 80 BD POP {R7, PC} 


38It has also to be noted the puts () does not require a ^n' new line symbol at the end of a string, so 
we do not see it here. 
39ciselant.de/projects/gcc printf/gcc printf.html 
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. Cstring:00003E70 48 65 6C 6C 6F 20+aHelloWorld DCB "Hello world!",0xA,0 


The BL and BLX instructions in Thumb mode, as we recall, are encoded as a pair of 
16-bit instructions. In Thumb-2 these surrogate opcodes are extended in such a way 
so that new instructions may be encoded here as 32-bit instructions. 


That is obvious considering that the opcodes of the Thumb-2 instructions always 
begin with OxFx or OxEx. 


But in the IDA listing the opcode bytes are swapped because for ARM processor the 
instructions are encoded as follows: last byte comes first and after that comes the 
first one (for Thumb and Thumb-2 modes) or for instructions in ARM mode the fourth 
byte comes first, then the third, then the second and finally the first (due to different 
endianness). 


So that is how bytes are located in IDA listings: 
* for ARM and ARM64 modes: 4-3-2-1; 
* for Thumb mode: 2-1; 
* for 16-bit instructions pair in Thumb-2 mode: 2-1-4-3. 
So as we can see, the MOVW, MOVT.W and BLX instructions begin with OxFx. 


One of the Thumb-2 instructions is MOVW RO, #0x13D8 —it stores a 16-bit value into 
the lower part of the RO register, clearing the higher bits. 


Also, MOVT.W R0, £0 works just like MOVT from the previous example only it works 
in Thumb-2. 


Among the other differences, the BLX instruction is used in this case instead of the 
BL. 


The difference is that, besides saving the RA^? in the LR register and passing control 
to the puts() function, the processor is also switching from Thumb/Thumb-2 mode 
to ARM mode (or back). 


This instruction is placed here since the instruction to which control is passed looks 
like (it is encoded in ARM mode): 


. Symbolstub1:00003FEC puts ; CODE XREF: hello world+E 
. symbolstub1:00003FEC 44 FO 9F E5 LDR PC, = imp puts 


This is essentially a jump to the place where the address of puts() is written in the 
imports' section. 


So, the observant reader may ask: why not call puts() right at the point in the code 
where it is needed? 


Because it is not very space-efficient. 


Almost any program uses external dynamic libraries (like DLL in Windows, .so in *NIX 
or .dylib in Mac OS X). The dynamic libraries contain frequently used library functions, 
including the standard C-function puts(). 


40Return Address 
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In an executable binary file (Windows PE .exe, ELF or Mach-O) an import section 
is present. This is a list of symbols (functions or global variables) imported from 
external modules along with the names of the modules themselves. 


The OS loader loads all modules it needs and, while enumerating import symbols in 
the primary module, determines the correct addresses of each symbol. 


In our case, imp puts is a 32-bit variable used by the OS loader to store the correct 
address of the function in an external library. Then the LDR instruction just reads the 
32-bit value from this variable and writes it into the PC register, passing control to 
it. 

So, in order to reduce the time the OS loader needs for completing this procedure, 
it is good idea to write the address of each symbol only once, to a dedicated place. 


Besides, as we have already figured out, it is impossible to load a 32-bit value into 
a register while using only one instruction without a memory access. 


Therefore, the optimal solution is to allocate a separate function working in ARM 
mode with the sole goal of passing control to the dynamic library and then to jump 
to this short one-instruction function (the so-called thunk function) from the Thumb- 
code. 


By the way, in the previous example (compiled for ARM mode) the control is passed 
by the BL to the same thunk function. The processor mode, however, is not being 
switched (hence the absence of an "X" in the instruction mnemonic). 


More about thunk-functions 


Thunk-functions are hard to understand, apparently, because of a misnomer. The 
simplest way to understand it as adaptors or convertors of one type of jack to an- 
other. For example, an adaptor allowing the insertion of a British power plug into 
an American wall socket, or vice-versa. Thunk functions are also sometimes called 
wrappers. 


Here are a couple more descriptions of these functions: 


"A piece of coding which provides an address:", according to P. Z. 
Ingerman, who invented thunks in 1961 as a way of binding actual 
parameters to their formal definitions in Algol-60 procedure calls. If a 
procedure is called with an expression in the place of a formal param- 
eter, the compiler generates a thunk which computes the expression 
and leaves the address of the result in some standard location. 


Microsoft and IBM have both defined, in their Intel-based systems, 
a "16-bit environment" (with bletcherous segment registers and 64K 
address limits) and a "32-bit environment" (with flat addressing and 
semi-real memory management). The two environments can both be 
running on the same computer and OS (thanks to what is called, in the 
Microsoft world, WOW which stands for Windows On Windows). MS and 
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IBM have both decided that the process of getting from 16- to 32-bit 
and vice versa is called a "thunk"; for Windows 95, there is even a tool, 
THUNK.EXE, called a "thunk compiler". 


( The Jargon File ) 


Another example we can find in LAPACK library—a "Linear Algebra PACKage" written 
in FORTRAN. C/C++ developers also want to use LAPACK, but it's insane to rewrite it 
to C/C++ and then maintain several versions. So there are short C functions callable 
from C/C++ environment, which are, in turn, call FORTRAN functions, and do almost 
anything else: 


double Blas Dot Prod(const LaVectorDouble &dx, const LaVectorDouble &dy) 
{ 
assert(dx.size()==dy.size()); 
integer n = dx.size(); 
integer incx = dx.inc(), incy = dy.inc(); 


return F77NAME(ddot)(&n, &dx(0), &incx, &dy(0), &incy); 


Also, functions like that are called "wrappers". 


ARM64 
GCC 


Let's compile the example using GCC 4.8.1 in ARM64: 
Listing 1.29: Non-optimizing GCC 4.8.1 + objdump 


0000000000400590 <main>: 


400590: a9bf7bfd stp x29, x30, [sp,#-16]! 
400594: 910003fd mov x29, sp 

400598: 90000000 adrp x0, 400000 < init-0x3b8> 
40059c: 91192000 add x0, x0, #0x648 

4005a0: 97ffffa0 bl 400420 <puts@plt> 
4005a4: 52800000 mov w0, #0x0 // #0 

4005a8: a8c17bfd ldp x29, x30, [sp], #16 
4005ac: d65f03c0 ret 


Contents of section .rodata: 
400640 01000200 00000000 48656c6c 6f210a00 ........ Hello!.. 


There are no Thumb and Thumb-2 modes in ARM64, only ARM, so there are 32-bit 
instructions only. The Register count is doubled: .2.4 on page 1317. 64-bit registers 
have X- prefixes, while its 32-bit parts—W-. 
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The STP instruction (Store Pair) saves two registers in the stack simultaneously: X29 
and X30. 


Of course, this instruction is able to save this pair at an arbitrary place in memory, 
but the SP register is specified here, so the pair is saved in the stack. 


ARM64 registers are 64-bit ones, each has a size of 8 bytes, so one needs 16 bytes 
for saving two registers. 


The exclamation mark ("!") after the operand means that 16 is to be subtracted 
from SP first, and only then are values from register pair to be written into the stack. 
This is also called pre-index. About the difference between post-index and pre-index 
read here: 1.39.2 on page 555. 


Hence, in terms of the more familiar x86, the first instruction is just an analogue 
to a pair of PUSH X29 and PUSH X30. X29 is used as FP^! in ARM64, and X30 as LR, 
so that's why they are saved in the function prologue and restored in the function 
epilogue. 


The second instruction copies SP in X29 (or FP). This is made so to set up the function 
stack frame. 


ADRP and ADD instructions are used to fill the address of the string "Hello!" into the 
X0 register, because the first function argument is passed in this register. There are 
no instructions, whatsoever, in ARM that can store a large number into a register 
(because the instruction length is limited to 4 bytes, read more about it here: 1.39.3 
on page 556). So several instructions must be utilized. The first instruction (ADRP) 
writes the address of the AKiB page, where the string is located, into X0, and the 
second one (ADD) just adds the remainder to the address. More about that in: 1.39.4 
on page 559. 


0x400000 + 0x648 = 0x400648, and we see our "Hello!" C-string in the .rodata 
data segment at this address. 


puts() is called afterwards using the BL instruction. This was already discussed: 
1.5.3 on page 28. 


MOV writes O into WO. WO is the lower 32 bits of the 64-bit X0 register: 


High 32-bit part | low 32-bit part 
X0 


WO 


The function result is returned via X0 and main() returns 0, so that's how the return 
result is prepared. But why use the 32-bit part? 


Because the int data type in ARM64, just like in x86-64, is still 32-bit, for better 
compatibility. 


So if a function returns a 32-bit int, only the lower 32 bits of X0 register have to be 
filled. 


In order to verify this, let's change this example slightly and recompile it. Now main() 
returns a 64-bit value: 


^lFrame Pointer 
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Listing 1.30: main() returning a value of uint64 t type 


#include <stdio.h> 
#include <stdint.h> 


uint64 t main() 

1 
printf ("Hello!\n"); 
return 0; 


} 


The result is the same, but that’s how MOV at that line looks like now: 


Listing 1.31: Non-optimizing GCC 4.8.1 + objdump 


4005a4: d2800000 mov x0, #0x0 // #0 


LDP (Load Pair) then restores the X29 and X30 registers. 


There is no exclamation mark after the instruction: this implies that the values are 
first loaded from the stack, and only then is SP increased by 16. This is called post- 
index. 


A new instruction appeared in ARM64: RET. It works just as BX LR, only a special hint 
bit is added, informing the CPU that this is a return from a function, not just another 
jump instruction, so it can execute it more optimally. 


Due to the simplicity of the function, optimizing GCC generates the very same code. 


1.5.4 MIPS 
A word about the "global pointer" 


One important MIPS concept is the "global pointer". As we may already know, each 
MIPS instruction has a size of 32 bits, so it's impossible to embed a 32-bit address 
into one instruction: a pair has to be used forthis (like GCC did in our example for the 
text string address loading). It's possible, however, to load data from the address 
in the range of register — 32768...register 4- 32767 using one single instruction (because 
16 bits of signed offset could be encoded in a single instruction). So we can allocate 
some register for this purpose and also allocate a 64KiB area of most used data. 
This allocated register is called a "global pointer" and it points to the middle of the 
64KiB area. This area usually contains global variables and addresses of imported 
functions like printf(), because the GCC developers decided that getting the ad- 
dress of some function must be as fast as a single instruction execution instead of 
two. In an ELF file this 64KiB area is located partly in sections .sbss ("small BSS^?") 
for uninitialized data and .sdata ("small data") for initialized data. This implies that 
the programmer may choose what data he/she wants to be accessed fast and place 
it into .sdata/.sbss. Some old-school programmers may recall the MS-DOS memory 
model 11.7 on page 1264 or the MS-DOS memory managers like XMS/EMS where all 
memory was divided in 64KiB blocks. 


This concept is not unique to MIPS. At least PowerPC uses this technique as well. 


42Block Started by Symbol 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


WO YO UU UNA 


34 


Optimizing GCC 
Let's consider the following example, which illustrates the “global pointer” concept. 


Listing 1.32: Optimizing GCC 4.4.5 (assembly output) 


$LCO: 
; N000 is zero byte in octal base: 
.ascii "Hello, world!\012\000" 


main: 
; function prologue. 
; set the GP: 


lui $28,%hi( gnu local gp) 

addiu $sp,$sp,-32 

addiu  $28,$28,%lo(_ gnu local gp) 
save the RA to the local stack: 


SW $31,28($sp) 
; load the address of the puts() function from the GP to $25: 
lw $25 ,%call16(puts) ($28) 
; load the address of the text string to $4 ($a0): 
lui $4,%hi($LCO) 
; Jump to puts(), saving the return address in the link register: 
jalr $25 


addiu $4,$4,%lo($LC0) ; branch delay slot 
restore the RA: 
lw $31,28($sp) 
; copy 0 from $zero to $v0: 
move $2,$0 
return by jumping to the RA: 
j $31 
; function epilogue: 
addiu $sp,$sp,32 ; branch delay slot + free local stack 


As we see, the $GP register is set in the function prologue to point to the middle of 
this area. The RA register is also saved in the local stack. puts() is also used here 
instead of printf(). The address of the puts() function is loaded into $25 using LW 
the instruction ("Load Word"). Then the address of the text string is loaded to $4 
using LUI ("Load Upper Immediate") and ADDIU ("Add Immediate Unsigned Word") 
instruction pair. LUI sets the high 16 bits of the register (hence "upper" word in 
instruction name) and ADDIU adds the lower 16 bits of the address. 


ADDIU follows JALR (haven't you forgot branch delay slots yet?). The register $4 is 
also called $A0, which is used for passing the first function argument ^. 


JALR ("Jump and Link Register") jumps to the address stored in the $25 register 
(address of puts()) while saving the address of the next instruction (LW) in RA. This 
is very similar to ARM. Oh, and one important thing is that the address saved in RA 
is not the address of the next instruction (because it's in a delay slot and is executed 
before the jump instruction), but the address of the instruction after the next one 
(after the delay slot). Hence, PC 4-8 is written to RA during the execution of JALR, in 
our case, this is the address of the LW instruction next to ADDIU. 


43The MIPS registers table is available in appendix .3.1 on page 1318 
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LW (“Load Word”) at line 20 restores RA from the local stack (this instruction is actu- 
ally part of the function epilogue). 
MOVE at line 22 copies the value from the $0 ($ZERO) register to $2 ($VO). 


MIPS has a constant register, which always holds zero. Apparently, the MIPS devel- 
opers came up with the idea that zero is in fact the busiest constant in the computer 
programming, so let's just use the $0 register every time zero is needed. 


Another interesting fact is that MIPS lacks an instruction that transfers data between 
registers. In fact, MOVE DST, SRC is ADD DST, SRC, $ZERO (DST = SRC +0), which 
does the same. Apparently, the MIPS developers wanted to have a compact opcode 
table. This does not mean an actual addition happens at each MOVE instruction. Most 
likely, the CPU optimizes these pseudo instructions and the ALU^^ is never used. 


J at line 24 jumps to the address in RA, which is effectively performing a return from 
the function. ADDIU after J is in fact executed before J (remember branch delay 
slots?) and is part of the function epilogue. Here is also a listing generated by IDA. 
Each register here has its own pseudo name: 


Listing 1.33: Optimizing GCC 4.4.5 (IDA) 


.text:00000000 main: 
.text:00000000 


.text:00000000 var 10 = -0x10 

.text:00000000 var 4 = -4 

. text: 00000000 

; function prologue. 

; set the GP: 

.text:00000000 lui $gp, ( gnu local gp >> 16) 
.text:00000004 addiu  $sp, -0x20 

. text: 00000008 la $gp, (. gnu local gp € OxFFFF) 
; save the RA to the local stack: 

.text:0000000C SW $ra, 0x20+var_4($sp) 


; save the GP to the local stack: 
; for some reason, this instruction is missing in the GCC assembly output: 


.text:00000010 SW $gp, 0x20«var 10($sp) 

; load the address of the puts() function from the GP to $t9: 

.text:00000014 lw $t9, (puts & OxFFFF) ($gp) 

; form the address of the text string in $a0: 

.text:00000018 lui $a0, ($LCO >> 16) # "Hello, world!" 

; jump to puts(), saving the return address in the link register: 

.text:0000001C jalr $t9 

.text:00000020 la $a0, ($LCO & OxFFFF) # "Hello, 
"lel! 

; restore the RA: 

.text:00000024 lw $ra, 0x20+var_4($sp) 

; copy O from $zero to $v0: 

.text:00000028 move $v0, $zero 

; return by jumping to the RA: 

.text:0000002C jr $ra 

; function epilogue: 

.text:00000030 addiu $sp, 0x20 


^^ Arithmetic Logic Unit 
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The instruction at line 15 saves the GP value into the local stack, and this instruction 
is missing mysteriously from the GCC output listing, maybe by a GCC error ^. The 
GP value has to be saved indeed, because each function can use its own 64KiB data 
window. The register containing the puts() address is called $T9, because registers 
prefixed with T- are called "temporaries" and their contents may not be preserved. 
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Non-optimizing GCC 


Non-optimizing GCC is more verbose. 


Listing 1.34: Non-optimizing GCC 4.4.5 (assembly output) 


$LCO: 


.ascii "Hello, world!X012N000" 


main: 


, 


, 


function prologue. 


; save the RA ($31) and FP in the stack: 


addiu $sp,$sp,-32 
SW $31,28($sp) 
SW $fp,24($sp) 
set the FP (stack frame pointer): 
move $fp,$sp 
set the GP: 
lui $28,%hi( gnu local gp) 
addiu  $28,$28,%lo(_ gnu local gp) 
load the address of the text string: 
lui $2,*shi($LCO) 
addiu $4,$2,%lo($LCO) 
load the address of puts() using the GP: 
lw $2, %call16(puts) ($28) 
nop 
call puts(): 
move $25 ,$2 
jalr $25 
nop ; branch delay slot 


restore the GP from the local stack: 
lw $28,16($fp) 

set register $2 ($V0) to zero: 
move $2,$0 

function epilogue. 

restore the SP: 
move $sp,$fp 

restore the RA: 


lw $31,28($sp) 
; restore the FP: 
lw $fp,24($sp) 


addiu  $sp,$Sp,32 
jump to the RA: 
j $31 
nop ; branch delay slot 


^5Apparently, functions generating listings are not so critical to GCC users, so some unfixed cosmetic 


bugs may still exist. 
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We see here that register FP is used as a pointer to the stack frame. We also see 3 
NOPs. The second and third of which follow the branch instructions. Perhaps the GCC 
compiler always adds NOPs (because of branch delay slots) after branch instructions 
and then, if optimization is turned on, maybe eliminates them. So in this case they 
are left here. 


Here is also IDA listing: 


Listing 1.35: Non-optimizing GCC 4.4.5 (IDA) 


.text:00000000 main: 
.text:00000000 
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.text:00000000 var 10 = -0x10 

.text:00000000 var 8 = -8 

.text:00000000 var 4 = -4 

. text: 00000000 

; function prologue. 

; save the RA and FP in the stack: 

. text: 00000000 addiu $sp, -0x20 

.text:00000004 SW $ra, 0x20+var_4($sp) 

.text:00000008 SW $fp, Ox20+var_8($sp) 

; set the FP (stack frame pointer): 

. text: 0000000C move $fp, $sp 

; set the GP: 

. text: 00000010 la $gp, __gnu_local_ gp 

. text: 00000018 SW $gp, 0x20«var 10($sp) 

; load the address of the text string: 

.text:0000001C lui $v0, (aHelloWorld >> 16) # "Hello, 
Tain 

text: 00000020 addiu $a0, $v0, (aHelloWorld € OxFFFF) + 


"Hello, world!" 


; load the address of puts() using the GP: 


.text:00000024 lw $v0O, (puts & OxFFFF) ($gp) 
.text:00000028 or $at, $zero ; NOP 

; call puts(): 

.text:0000002C move $t9, $v0 
.text:00000030 jalr $t9 

.text:00000034 or $at, $zero ; NOP 

; restore the GP from local stack: 

.text:00000038 lw $gp, 0x20+var_10($fp) 
; set register $2 ($VO) to zero: 

.text:0000003C move $v0, $zero 

; function epilogue. 

; restore the SP: 

.text:00000040 move $sp, $fp 

; restore the RA: 

.text:00000044 lw $ra, 0x20+var_4($sp) 
; restore the FP: 

.text:00000048 lw $fp, 0x20-var 8($sp) 
.text:0000004C addiu  $sp, 0x20 

; jump to the RA: 

.text:00000050 jr $ra 

. text: 00000054 or $at, $zero ; NOP 


Interestingly, IDA recognized the LUI/ADDIU instructions pair and coalesced them 
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into one LA ("Load Address") pseudo instruction at line 15. We may also see that 
this pseudo instruction has a size of 8 bytes! This is a pseudo instruction (or macro) 
because it's not a real MIPS instruction, but rather a handy name for an instruction 
pair. 


Another thing is that IDA doesn't recognize NOP instructions, so here they are at 
lines 22, 26 and 41. Itis OR $AT, $ZERO. Essentially, this instruction applies the OR 
operation to the contents of the $AT register with zero, which is, of course, an idle 
instruction. MIPS, like many other ISAs, doesn't have a separate NOP instruction. 


Role of the stack frame in this example 


The address of the text string is passed in the register. Why setup a local stack 
anyway? The reason for this lies in the fact that the values of registers RA and GP 
have to be saved somewhere (because printf() is called), and the local stack is 
used for this purpose. If this was a leaf function, it would have been possible to get 
rid of the function prologue and epilogue, for example: 1.4.3 on page 11. 


Optimizing GCC: load it into GDB 


Listing 1.36: sample GDB session 


root@debian-mips:~# gcc hw.c -03 -o hw 


root@debian-mips:~# gdb hw 
GNU gdb (GDB) 7.0.1-debian 


Reading symbols from /root/hw...(no debugging symbols found)...done. 
(gdb) b main 

Breakpoint 1 at 0x400654 

(gdb) run 

Starting program: /root/hw 


Breakpoint 1, 0x00400654 in main () 

(gdb) set step-mode on 

(gdb) disas 

Dump of assembler code for function main: 


0x00400640 <main+0>: lui gp, 0x42 
0x00400644 <main+4>: addiu sp,sp,-32 
0x00400648 <main+8>: addiu gp, gp, -30624 
0x0040064c <main+12>: SW ra,28(sp) 
0x00400650 <main+16>: sw gp, 16(sp) 
0x00400654 <main+20>: lw t9, -32716(gp) 
0x00400658 <main+24>: lui a0,0x40 


0x0040065c <main+28>: jalr t9 
0x00400660 <main+32>: addiu a0,a0,2080 


0x00400664 <main+36>: lw ra,28(sp) 
0x00400668 <main+40>: move v0,zero 
0x0040066c <main+44>: jr ra 


0x00400670 <main+48>: addiu — sp, sp,32 
End of assembler dump. 
(gdb) s 
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0x00400658 in main () 

(gdb) s 

0x0040065c in main () 

(gdb) s 

Ox2ab2de60 in printf () from /lib/libc.so.6 
(gdb) x/s $a0 

0x400820: "hello, world" 

(gdb) 


1.5.5 Conclusion 


The main difference between x86/ARM and x64/ARM64 code is that the pointer to 
the string is now 64-bits in length. Indeed, modern CPUs are now 64-bit due to both 
the reduced cost of memory and the greater demand for it by modern applications. 
We can add much more memory to our computers than 32-bit pointers are able to 
address. As such, all pointers are now 64-bit. 


1.5.6 Exercises 


* http://challenges.re/48 
* http://challenges.re/49 


1.6 Function prologue and epilogue 


A function prologue is a sequence of instructions at the start of a function. It often 
looks something like the following code fragment: 


push ebp 
mov ebp, esp 
sub esp, X 


What these instruction do: save the value of the EBP register on the stack, set the 
value of the EBP register to the value of the ESP and then allocate space on the stack 
for local variables. 


The value in the EBP stays the same over the period of the function execution and is 
to be used for local variables and arguments access. For the same purpose one can 
use ESP, but since it changes over time this approach is not too convenient. 


The function epilogue frees the allocated space in the stack, returns the value in the 
EBP register back to its initial state and returns the control flow to the caller: 


mov esp, ebp 
pop ebp 
ret 0 


Function prologues and epilogues are usually detected in disassemblers for function 
delimitation. 
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1.6.1 Recursion 
Epilogues and prologues can negatively affect the recursion performance. 


More about recursion in this book: 3.7.3 on page 600. 


1.7 An Empty Function: redux 


Let's back to the empty function example 1.3 on page 7. Now that we know about 
function prologue and epilogue, this is an empty function 1.1 on page 7 compiled by 
non-optimizing GCC: 


Listing 1.37: Non-optimizing GCC 8.2 x64 (assembly output) 


f: 
push rbp 
mov rbp, rsp 
nop 
pop rbp 
ret 


It's RET, but function prologue and epilogue, probably, wasn't optimized and left as 
is. NOP it seems is another compiler artifact. Anyway, the only effective instruction 
here is RET. All other instructions can be removed (or optimized). 


1.8 Returning Values: redux 


Again, when we know about function prologue and epilogue, let's recompile an ex- 
ample returning a value (1.4 on page 10, 1.8 on page 10) using non-optimizing GCC: 


Listing 1.38: Non-optimizing GCC 8.2 x64 (assembly output) 


f: 
push rbp 
mov rbp, rsp 
mov eax, 123 
pop rbp 
ret 


Effective instructions here are MOV and RET, others are - prologue and epilogue. 


1.9 Stack 


The stack is one of the most fundamental data structures in computer science ^9. 
AKA" LIFO*. 
^6wikipedia.org/wiki/Call stack 


47 Also Known As 
481 ast In First Out 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


41 


Technically, it is just a block of memory in process memory along with the ESP or RSP 
register in x86 or x64, or the SP register in ARM, as a pointer within that block. 


The most frequently used stack access instructions are PUSH and POP (in both x86 
and ARM Thumb-mode). PUSH subtracts from ESP/RSP/SP 4 in 32-bit mode (or 8 in 
64-bit mode) and then writes the contents of its sole operand to the memory address 
pointed by ESP/RSP/SP. 


POP is the reverse operation: retrieve the data from the memory location that SP 
points to, load it into the instruction operand (often a register) and then add 4 (or 8) 
to the stack pointer. 


After stack allocation, the stack pointer points at the bottom of the stack. PUSH 
decreases the stack pointer and POP increases it. The bottom of the stack is actually 
at the beginning of the memory allocated for the stack block. It seems strange, but 
that's the way it is. 


ARM supports both descending and ascending stacks. 


For example the STMFD/LDMFD, STMED^?/LDMED?? instructions are intended to deal 
with a descending stack (grows downwards, starting with a high address and pro- 
gressing to a lower one). The STMFA?! /LDMFA??, STMEA??/LDMEA?^4 instructions are 
intended to deal with an ascending stack (grows upwards, starting from a low ad- 
dress and progressing to a higher one). 


1.9.1 Why does the stack grow backwards? 


Intuitively, we might think that the stack grows upwards, i.e. towards higher ad- 
dresses, like any other data structure. 


The reason that the stack grows backward is probably historical. When the comput- 
ers were big and occupied a whole room, and memory limited to only a few thousand 
bytes, it was easy to divide memory into two parts, one for the heap and one for the 
stack. Of course, it was unknown how big the heap and the stack would be during 
program execution, so this solution was the simplest possible. 


Start of heap Start of stack 


Heap — «— Stack 


In [D. M. Ritchie and K. Thompson, The UNIX Time Sharing System, (1974)]"?we can 
read: 


49Store Multiple Empty Descending (ARM instruction) 
501 oad Multiple Empty Descending (ARM instruction) 
51Store Multiple Full Ascending (ARM instruction) 

521 0ad Multiple Full Ascending (ARM instruction) 
53Store Multiple Empty Ascending (ARM instruction) 
541 oad Multiple Empty Ascending (ARM instruction) 
55Also available as URL 
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The user-core part of an image is divided into three logical seg- 
ments. The program text segment begins at location O in the virtual 
address space. During execution, this segment is write-protected and 
a single copy of it is shared among all processes executing the same 
program. At the first 8K byte boundary above the program text seg- 
ment in the virtual address space begins a nonshared, writable data 
segment, the size of which may be extended by a system call. Starting 
at the highest address in the virtual address space is a stack segment, 
which automatically grows downward as the hardware's stack pointer 
fluctuates. 


This reminds us how some students write two lecture notes using only one notebook: 
notes for the first lecture are written as usual, and notes for the second one are writ- 
ten from the end of notebook, by flipping it. Notes may meet each other somewhere 
in between, in case of lack of free space. 


1.9.2 What is the stack used for? 
Save the function’s return address 


x86 


When calling another function with a CALL instruction, the address of the point ex- 
actly after the CALL instruction is saved to the stack and then an unconditional jump 
to the address in the CALL operand is executed. 


The CALL instruction is equivalent to a 
PUSH address after call / JMP operand instruction pair. 


RET fetches a value from the stack and jumps to it —that is equivalent to a POP tmp 
/ JMP tmp instruction pair. 


Overflowing the stack is straightforward. Just run eternal recursion: 


void f() 
1 


FQ); 


MSVC 2008 reports the problem: 


c:\tmp6>cl ss.cpp /Fass.asm 

Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 15.00.21022.08 for 7 
S 80x86 

Copyright (C) Microsoft Corporation. All rights reserved. 


SS.Cpp 
c:\tmp6\ss.cpp(4) : warning C4717: 'f' : recursive on all control paths, 7 
y function will cause runtime stack overflow 
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...but generates the right code anyway: 


?F@@YAXXZ PROC kom 
; Line 2 

push ebp 

mov ebp, esp 
; Line 3 

call ? F@@YAXXZ "EN 
; Line 4 

pop ebp 

ret 0 
?F@@YAXXZ ENDP Df 


...Also if we turn on the compiler optimization (/0x option) the optimized code will 
not overflow the stack and will work correctly? instead: 


? f@@YAXXZ PROC E 
; Line 2 
$LL3Qf : 
; Line 3 

jmp SHORT $LL3@f 
?f@@YAXXZ ENDP nf 


GCC 4.4.1 generates similar code in both cases without, however, issuing any warn- 
ing about the problem. 


ARM 


ARM programs also use the stack for saving return addresses, but differently. As 
mentioned in “Hello, world!” (1.5.3 on page 24), the RA is saved to the LR (link 
register). If one needs, however, to call another function and use the LR register one 
more time, its value has to be saved. Usually it is saved in the function prologue. 


Often, we see instructions like PUSH R4-R7,LR along with this instruction in epilogue 
POP R4-R7,PC—thus register values to be used in the function are saved in the stack, 
including LR. 


Nevertheless, if a function never calls any other function, in RISC terminology it is 
called a leaf function?/. As a consequence, leaf functions do not save the LR register 
(because they don't modify it). If such function is small and uses a small number of 
registers, it may not use the stack at all. Thus, it is possible to call leaf functions 
without using the stack, which can be faster than on older x86 machines because 
external RAM is not used for the stack °°. This can be also useful for situations when 
memory for the stack is not yet allocated or not available. 


56irony here 

57infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.faqs/ka13785.html 

58Some time ago, on PDP-11 and VAX, the CALL instruction (calling other functions) was expensive; up 
to 50% of execution time might be spent on it, so it was considered that having a big number of small 
functions is an anti-pattern [Eric S. Raymond, The Art of UNIX Programming, (2003)Chapter 4, Part II]. 
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Some examples of leaf functions: 1.14.3 on page 133, 1.14.3 on page 133, 1.282 
on page 395, 1.298 on page 417, 1.28.5 on page 417, 1.192 on page 264, 1.190 on 
page 261, 1.209 on page 285. 


Passing function arguments 


The most popular way to pass parameters in x86 is called "cdecl": 


push arg3 

push arg2 

push argl 

call f 

add esp, 12 ; 4*3-12 


Callee functions get their arguments via the stack pointer. 


Therefore, this is how the argument values are located in the stack before the exe- 
cution of the f () function's very first instruction: 


ESP return address 

ESP+4 argument#1, marked in IDA as arg 0 
ESP+8 argument#2, marked in IDA as arg 4 
ESP+0xC | argument#3, marked in IDA as arg 8 


For more information on other calling conventions see also section (6.1 on page 932). 


By the way, the callee function does not have any information about how many 
arguments were passed. C functions with a variable number of arguments (like 
printf()) can determine their number using format string specifiers (which begin 
with the 96 symbol). 


If we write something like: 


printf("sd %d Sd", 1234); 


printf() will print 1234, and then two random numbers??, which were lying next to 
it in the stack. 


That's why it is not very important how we declare the main() function: as main(), 
main(int argc, char *argv[]) ormain(int argc, char *argv[], char *envp[]). 


In fact, the CRT-code is calling main() roughly as: 


push envp 
push argv 
push argc 
call main 


If you declare main() as main() without arguments, they are, nevertheless, still 
present in the stack, but are not used. If you declare main() as main(int argc, 


59Not random in strict sense, but rather unpredictable: 1.9.4 on page 50 
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char *argv[]), you will be able to use first two arguments, and the third will remain 
"invisible" for your function. Even more, it is possible to declare main(int argc), 
and it will work. 


Another related example: 6.1.10. 
Alternative ways of passing arguments 


It is worth noting that nothing obliges programmers to pass arguments through the 
stack. It is not a requirement. One could implement any other method without using 
the stack at all. 


A somewhat popular way among assembly language newbies is to pass arguments 
via global variables, like: 


Listing 1.39: Assembly code 


mov X, 123 

mov Y, 456 

call do something 
X dd ? 
Y dd ? 
do something proc near 

; take X 

; take Y 

; do something 

retn 


do something endp 


But this method has obvious drawback: do something() function cannot call itself 
recursively (or via another function), because it has to zap its own arguments. The 
same story with local variables: if you hold them in global variables, the function 
couldn't call itself. And this is also not thread-safe ©°. A method to store such infor- 
mation in stack makes this easier—it can hold as many function arguments and/or 
values, as stack space it has. 


[Donald E. Knuth, The Art of Computer Programming, Volume 1, 3rd ed., (1997), 189] 
mentions even weirder schemes particularly convenient on IBM System/360. 


MS-DOS had a way of passing all function arguments via registers, for example, this 
is piece of code for ancient 16-bit MS-DOS prints "Hello, world!": 


mov dx, msg ; address of message 
mov ah, 9 ; 9 means "print string" function 
int 21h ; DOS "syscall" 


S9 Correctly implemented, each thread would have its own stack with its own arguments/variables. 
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mov ah, 4ch ; "terminate program" function 
int 21h ; DOS "syscall" 


msg db ‘Hello, World!\$' 


This is quite similar to 6.1.3 on page 934 method. And also it’s very similar to calling 
syscalls in Linux (6.3.1 on page 951) and Windows. 


If an MS-DOS function is going to return a boolean value (i.e., single bit, usually 
indicating error state), the CF flag was often used. 


For example: 


mov ah, 3ch ; create file 
lea dx, filename 

mov cl, 1 

int 21h 

jc error 

mov file handle, ax 


error: 


In case of an error, the CF flag is set. Otherwise, the handle of the newly created file 
is returned via AX. 


This method is still used by assembly language programmers. In Windows Research 
Kernel source code (which is quite similar to Windows 2003) we can find something 
like this (file base/ntos/ke/i386/cpu.asm): 


public Get386Stepping 
Get386Stepping proc 


call MultiplyTest ; Perform multiplication test 
jnc short G3s00 ; if nc, muttest is ok 
mov ax, 0 
ret 
G3s00: 
call Check386B0 ; Check for BO stepping 
jnc short G3s05 ; if nc, it's Bl/later 
mov ax, 100h ; It is B0/earlier stepping 
ret 
G3s05: 
call Check386D1 ; Check for D1 stepping 
jc short G3s10 ; if c, it is NOT D1 
mov ax, 301h ; It is D1/later stepping 
ret 
G3s10: 
mov ax, 101h ; assume it is Bl stepping 
ret 
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MultiplyTest proc 


xor CX,CX ; 64K times is a nice round number 
mlt00: push Cx 
call Multiply ; does this chip's multiply work? 
pop CX 
jc short mltx ; if c, No, exit 
loop mlt00 ; if nc, YEs, loop to try again 
clc 
mltx: 
ret 


MultiplyTest endp 


Local variable storage 


A function could allocate space in the stack for its local variables just by decreasing 
the stack pointer towards the stack bottom. 


Hence, it's very fast, no matter how many local variables are defined. It is also not 
a requirement to store local variables in the stack. You could store local variables 
wherever you like, but traditionally this is how it's done. 


x86: alloca() function 


It is worth noting the alloca() function ©. This function works like malloc(), but 
allocates memory directly on the stack. The allocated memory chunk does not have 
to be freed via a free() function call, 

since the function epilogue (1.6 on page 39) returns ESP back to its initial state and 
the allocated memory is just dropped. It is worth noting how alloca() is imple- 
mented. In simple terms, this function just shifts ESP downwards toward the stack 
bottom by the number of bytes you need, making ESP pointing to the a/located block. 


Let's try: 


#ifdef | GNUC — 

#include «alloca.h» // GCC 
#else 

#include <malloc.h> // MSVC 
Hendif 

#include <stdio.h> 


void f() 
1 
char *buf=(char*)alloca (600); 


#ifdef | GNUC - 
snprintf (buf, 600, "hi! %d, %d, %d\n", 1, 2, 3); // GCC 


$1In MSVC, the function implementation can be found in allocal6.asm and chkstk.asm in 
C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\crt\src\intel 
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#else 
_snprintf (buf, 600, "hi! %d, %d, %d\n", 1, 2, 3); // MSVC 
#endif 


puts (buf); 
}; 


 snprintf() function works just like printf(), but instead of dumping the result 
into stdout (e.g., to terminal or console), it writes it to the buf buffer. Function puts() 
copies the contents of buf to stdout. Of course, these two function calls might be 
replaced by one printf() call, but we have to illustrate small buffer usage. 


MSVC 


Let's compile (MSVC 2010): 
Listing 1.40: MSVC 2010 


mov eax, 600 ; 00000258H 


call alloca probe 16 
mov esi, esp 

push 3 

push 2 

push 1 

push OFFSET $5G2672 
push 600 ; 00000258H 
push esi 

call snprintf 

push esi 

call | puts 


add esp, 28 


The sole alloca() argument is passed via EAX (instead of pushing it into the stack) 
62 


GCC + Intel syntax 


GCC 4.4.1 does the same without calling external functions: 


$2It is because alloca() is rather a compiler intrinsic (11.4 on page 1258) than a normal function. One of 
the reasons we need a separate function instead of just a couple of instructions in the code, is because 
the MSVCS” alloca() implementation also has code which reads from the memory just allocated, in order 
to let the OS map physical memory to this VMÓ^ region. After the alloca() call, ESP points to the block 
of 600 bytes and we can use it as memory for the buf array. 
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Listing 1.41: GCC 4.7.3 


.LC0: 
.String "hi! %d, %d, %d\n" 
f: 
push ebp 
mov ebp, esp 
push ebx 
sub esp, 660 
lea ebx, [esp+39] 
and ebx, -16 ; align pointer by 16-byte border 
mov DWORD PTR [esp], ebx HIE 
mov DWORD PTR [esp+20], 3 
mov DWORD PTR [esp+16], 2 
mov DWORD PTR [esp+12], 1 
mov DWORD PTR [esp+8], OFFSET FLAT:.LCO ; "hi! %d, %d, “din” 
mov DWORD PTR [esp+4], 600 ; maxlen 
call _snprintf 
mov DWORD PTR [esp], ebx ; S 
call puts 
mov ebx, DWORD PTR [ebp-4] 
leave 
ret 


GCC + AT&T syntax 


Let’s see the same code, but in AT&T syntax: 


Listing 1.42: GCC 4.7.3 


.LC0: 
.string "hi! %d, %d, %d\n" 


pushl %ebp 
movl “esp, *sebp 
pushl %ebx 
subl $660, %esp 


leal 39(%esp), %ebx 
andl $-16, %ebx 
movl *sebx, (%esp) 
movl $3, 20(%esp) 
movl $2, 16(%esp) 
movl $1, 12(%esp) 
movl $.LCO, 8(%esp) 
movl $600, 4(%esp) 
call _snprintf 

movl %ebx, (%esp) 
call puts 

movl -4(%ebp), %ebx 
leave 

ret 
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The code is the same as in the previous listing. 


By the way, movl $3, 20(%esp) corresponds to mov DWORD PTR [esp+20], 3 in 
Intel-syntax. In the AT&T syntax, the register offset format of addressing memory 
looks like offset(*sregister). 


(Windows) SEH 


SEH? records are also stored on the stack (if they are present). Read more about it: 
(6.5.3 on page 973). 


Buffer overflow protection 


More about it here (1.26.2 on page 340). 


Automatic deallocation of data in stack 


Perhaps the reason for storing local variables and SEH records in the stack is that 
they are freed automatically upon function exit, using just one instruction to correct 
the stack pointer (it is often ADD). Function arguments, as we could say, are also 
deallocated automatically at the end of function. In contrast, everything stored in 
the heap must be deallocated explicitly. 


1.9.3 Atypical stack layout 


A typical stack layout in a 32-bit environment at the start of a function, before the 
first instruction execution looks like this: 


ESP-OxC | local variable#2, marked in IDA as var 8 


ESP-8 local variable#1, marked in IDA as var 4 
ESP-4 saved value ofEBP 
ESP Return Address 


ESP+4 argument#1, marked in IDA as arg 0 
ESP+8 argument#2, marked in IDA as arg 4 
ESP+0xC | argument£3, marked in IDA as arg 8 


1.9.4 Noise in stack 


When one says that something seems 
random, what one usually means in practice 
is that one cannot see any regularities in it. 


Stephen Wolfram, A New Kind of Science. 


Often in this book "noise" or "garbage" values in the stack or memory are mentioned. 
Where do they come from? These are what has been left there after other functions’ 
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executions. Short example: 


#include <stdio.h> 


void f1() 
{ 
int a=1, b=2, c=3; 
$; 
void f2() 
1 
int a, b, C; 
printf ("%d, %d, %d\n", a, b, c); 
P 
int main() 
1 
f1(); 
f2(); 
$; 
Compiling ... 

Listing 1.43: Non-optimizing MSVC 2010 
$SG2752 DB '*d, %d, %d', OaH, OOH 
_c$ = -12 ; size = 4 
_b$ = -8 ; size = 4 
_ag = -4 ; size = 4 
fl PROC 

push ebp 
mov ebp, esp 
sub esp, 12 
mov DWORD PTR a$[ebp], 1 
mov DWORD PTR b$[ebp], 2 
mov DWORD PTR c$[ebp], 3 
mov esp, ebp 
pop ebp 
ret 0 

f1 ENDP 

c$ = -12 ; size = 4 

b$ = -8 ; size = 4 

_ag = -4 ; size = 4 
_f2 PROC 

push ebp 
mov ebp, esp 
sub esp, 12 
mov eax, DWORD PTR _c$[ebp] 
push eax 
mov ecx, DWORD PTR _b$[ebp] 
push ecx 
mov edx, DWORD PTR a$[ebp] 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


52 


push edx 
push OFFSET $5G2752 ; '*d, %d, %d' 
call DWORD PTR imp printf 


add esp, 16 
mov esp, ebp 
pop ebp 
ret 0 

E ENDP 

main PROC 
push ebp 
mov ebp, esp 
call .f1 
call _f2 
xor eax, eax 
pop ebp 
ret 0 

_main  ENDP 


The compiler will grumble a little bit... 


c:\Polygon\c>cl st.c /Fast.asm /MD 

Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 16.00.40219.01 for v 
«y 80x86 

Copyright (C) Microsoft Corporation. All rights reserved. 


st.c 

c:\polygon\c\st.c(11) : warning C4700: uninitialized local variable 'c' 7 
V used 

c:\polygon\c\st.c(11) : warning C4700: uninitialized local variable 'b' v 
V used 

c:\polygon\c\st.c(11) : warning C4700: uninitialized local variable 'a' 7 
y used 


Microsoft (R) Incremental Linker Version 10.00.40219.01 
Copyright (C) Microsoft Corporation. All rights reserved. 


/out:st.exe 
st.obj 


But when we run the compiled program ... 


c:\Polygon\c>st 
1;.2; 3 


Oh, what a weird thing! We did not set any variables in f2(). These are "ghosts" 
values, which are still in the stack. 
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Let's load the example into OllyDbg: 


PUSH EBP 

MOU EBP,ESP 

SUB ESP, ØC 

MOV DWORD PTR SS:CLOCAL.1],1 
MOV DWORD PTR SS:CLOCAL.2],2 
MOU DWORD PTR SS: CLOCAL.3],3 
MOU ESP,EBP 


POP EBP' 

RETN 

INTS 

PUSH EBP > t.G12C101B 

MOU EBP,ESP ; | 32bit ØLFFFFFFFF) 


wor mo. m ss af 


SUB ESP, BC e 
HOU EAX, DWORD PTR $$: CLOCAL.3] eerie DIEEEEEEEE S 
MOU ECX, DWORD PTR : l PODER 


t rEFDDaaatFFF) 
t GCFFFFFFFF) 


BO ER 


RETURN from 


RETURN from st.@12C 
RETURN from st.@12C 


m 


Figure 1.6: OllyDbg: f1() 


When f1() assigns the variables a, b and c, their values are stored at the address 
0x1FF860 and so on. 
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And when f2() executes: 


OllyDbg - st.exe 
File View Debug Trace Plugins Options Windows Help 


CPU - main thread, module st 


1 + 83EC ØC SUB ESP, ØC 
* 8B45 F4 — PTR SS: CLOCAL.31] 


50 

8B4D FS MOY, ECX, DWORD PTR SS:CLOCAL.2] 0 ~ cpt wanaran 
2B55 FC MOV EDX,DWORD PTR SS:ErLOCRL.11 
52 PUSH EDX 

68 BOBG2CG1 | PUSH OFFSET 012CB000 
Es 25000900 91201661 

3304 10 a 
EIP B12C1026 st.612C1626 


ES BLFFFFFFFF) 
Bt FFFFFFFF) 
@( FFFFFFFF} 
OLFFFFFFFF) 
7EFDDaBat FFF) 


= & 
Stack [001FF858]=3 Ar f 
EAX=000C2880 a S al A O 


e 


MS, O| RETURN from st.612C 
$ 


¿6| RETURN from st.@12C 


,8) RETURN from st.@12C 
v 


Figure 1.7: OllyDbg: f2() 


. a, band c of f2() are located at the same addresses! No one has overwritten the 
values yet, so at that point they are still untouched. So, for this weird situation to 
occur, several functions have to be called one after another and SP has to be the 
same at each function entry (i.e., they have the same number of arguments). Then 
the local variables will be located at the same positions in the stack. Summarizing, 
all values in the stack (and memory cells in general) have values left there from 
previous function executions. They are not random in the strict sense, but rather 
have unpredictable values. Is there another option? It would probably be possible 
to clear portions of the stack before each function execution, but that's too much 
extra (and unnecessary) work. 


MSVC 2013 


The example was compiled by MSVC 2010. Butthe reader of this book made attempt 
to compile this example in MSVC 2013, ran it, and got all 3 numbers reversed: 


c:\Polygon\c>st 
3, 2, 1 


Why? I also compiled this example in MSVC 2013 and saw this: 
Listing 1.44: MSVC 2013 


las = -12 ; size = 4 
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_b$ = -8 ; size = 4 
_c$ = -4 ; size = 4 
f2 PROC 
f2 ENDP 
_c$ = -12 ; size = 4 
b$ = -8 * size - 4 
_a$ = -4 ; size = 4 
“fl PROC 
f ENDP 


Unlike MSVC 2010, MSVC 2013 allocated a/b/c variables in function f2() in reverse 
order. And this is completely correct, because C/C++ standards has no rule, in which 
order local variables must be allocated in the local stack, if at all. The reason of dif- 
ference is because MSVC 2010 has one way to do it, and MSVC 2013 has supposedly 
something changed inside of compiler guts, so it behaves slightly different. 


1.9.5 Exercises 


* http://challenges.re/51 
* http://challenges.re/52 


1.10 Almost empty function 


This is a real piece of code | found in Boolector 5: 


// forward declaration. the function is residing in some other module: 
int boolector main (int argc, char **argv); 


// executable 
int main (int argc, char **argv) 


1 
} 


return boolector main (argc, argv); 


Why would anyone do so? It’s unclear, but we can guess that boolector main() 
may be compiled in some kind of DLL or dynamic library, and be called from a test 
suite. Surely, a test suite can prepare argc/argv variables as CRT would do it. 


Interestingly enough, this is how it compiles: 


66https://boolector.github.io/ 
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Listing 1.45: Non-optimizing GCC 8.2 x64 (assembly output) 


main: 
push rbp 
mov rbp, rsp 
sub rsp, 16 
mov DWORD PTR -4[rbp], edi 
mov QWORD PTR -16[rbp], rsi 
mov rdx, QWORD PTR -16[rbp] 
mov eax, DWORD PTR -4[rbp] 
mov rsi, rdx 
mov edi, eax 
call boolector main 
leave 
ret 


We've got here: prologue, unnecessary (not optimized) shuffling of two arguments, 
CALL, epilogue, RET. But let's see optimizing version: 


Listing 1.46: Optimizing GCC 8.2 x64 (assembly output) 


main: 
jmp boolector main 


As simple as that: stack/registers are untouched and boolector main() has the 
same arguments set. So all we need to do is pass execution to another address. 


This is close to thunk function. 
We will see something more advanced later: 1.11.2 on page 71, 1.21.1 on page 197. 


1.11 printf() with several arguments 


Now let's extend the Hello, world! (1.5 on page 11) example, replacing printf() in 
the main() function body with this: 


#include <stdio.h> 


int main() 

{ 
printf ("a=%d; b=%d; c=%d", 1, 2, 3); 
return 0; 


ur 


1.11.1 x86 
x86: 3 integer arguments 


MSVC 


When we compile it with MSVC 2010 Express we get: 
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$SG3830 DB 'a=%d; b=%d; c=%d', 00H 
push 3 
push 2 
push 1 
push OFFSET $5G3830 
call _printf 
add esp, 16 ; 00000010H 


Almost the same, but now we can see the printf () arguments are pushed onto the 
stack in reverse order. The first argument is pushed last. 


By the way, variables of int type in 32-bit environment have 32-bit width, that is 4 
bytes. 


So, we have 4 arguments here. 4+4 = 16 —they occupy exactly 16 bytes in the stack: 
a 32-bit pointer to a string and 3 numbers of type int. 


When the stack pointer (ESP register) has changed back by the 
ADD ESP, Xinstruction after a function call, often, the number of function arguments 
could be deduced by simply dividing X by 4. 


Of course, this is specific to the cdecl calling convention, and only for 32-bit environ- 
ment. 


See also the calling conventions section (6.1 on page 932). 


In certain cases where several functions return right after one another, the compiler 
could merge multiple "ADD ESP, X" instructions into one, after the last call: 


push al 
push a2 
call ... 
push al 
call ... 
push al 
push a2 
push a3 


call ... 
add esp, 24 


Here is a real-world example: 


Listing 1.47: x86 


.text:100113E7 push 3 

.text:100113E9 call sub 100018B0 ; takes one argument (3) 
.text:100113EE call sub 100019D0 ; takes no arguments at all 
.text:100113F3 call sub 10006490 ; takes no arguments at all 
.text:100113F8 push 1 

.text:100113FA call sub 100018B0 ; takes one argument (1) 
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.text:100113FF add esp, 8 ; drops two arguments from stack at | 
once 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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MSVC and OllyDbg 


Now let's try to load this example in OllyDbg. It is one of the most popular user-land 
win32 debuggers. We can compile our example in MSVC 2012 with /MD option, which 
means to link with MSVCR* .DLL, so we can see the imported functions clearly in the 
debugger. 


Then load the executable in OllyDbg. The very first breakpoint is in ntdll.dll, press 
F9 (run). The second breakpoint is in CRT-code. Now we have to find the main() 
function. 


Find this code by scrolling the code to the very top (MSVC allocates the main() func- 
tion at the very beginning of the code section): 


CPU - main thread, module 1 


PUSH EBP Registers (FPU) 
ee AX 6R3B8634 MSUCRIIB.  initenv 
CX BBSBCE1S 
PUSH 2 aaaooaooa 
PUSH 1 E 
PUSH OFFSET 012F3000 ESP BO22F93C 
CALL DWORD PTR DS:C<&MSUCR116. printf >] "P BBS2FO?S 
ADD ESP, 18 SI 00 
XOR EAX, EAX 
POP EBP a CO 
ca RETN 1.012F1000 
B8 405A0000_|MOU EAX, 5A4D CO ES M02B 22bit BLFFFFFFFF) 
66:3905 900) CHP WORD PTR_DS: [<STRUCT IMRGE DOS HERD 51 a bit BLFFFFFFFF) 
74 04 JE SHORT 612F162D AG SS 000 22bit GlFFFFFFFF) 
SOR EAX, EAX : G bit B(FFFFFFFF) 
Dp HT 4 Š so FSG bit 7EFDDBaBtFFF) 
O GS 0B2B 32bit B(FFFFFFFF) 


0 O LastErr 00000000 ERROR SUCCESS 


246 (NO,NB,E,BE,NS,PE,GE,LE) 
Address [Heu dump —  —— (ASCII (MMSI a 
012 ajel 5 2 25 = 25 6 b 


64|8 


"vi 


FE FF FF FF|FF 
64 ag aa 00| 0A 


1 
j 


øl øl 5| 
aan a an pus 
an a au aa 


aa a au 6a 
aa a" aa 66 
aa aa ag aun aa aa a 


a ag ao ao aa 00100 aa aao oo 


Figure 1.8: OllyDbg: the very start of the main() function 


Click on the PUSH EBP instruction, press F2 (set breakpoint) and press F9 (run). We 
have to perform these actions in order to skip CRT-code, because we aren't really 
interested in it yet. 
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main thread, module 1 

PUSH EBP 
MOU EBP,ESP 
PUSH 3 

PUSH 2 


68 Büsgerol |PUSH OFFSET p12F3000 A E 
FFIS SüZüeFü CALL DUORD PTR DS: [<&MSUCR110.printf>] > Q022F328 PTR to ASCII "acidi 


—initeny 


SOR EAK? Efx 
POP EBP 


zi ooE 1.012F100E 

MOU EAX, 5A4D C E bit e(FFFFFFFF) 

G29) CMP WORD PTR DS:L«STRUCT IMAGE DOS. HERDI P1 BL FFFFFFFF) 
JE SHORT 012F1020 aë Ot EFFEFFFF) 

OR SET z OLFFFFFFFF) 
La es 8 7EFDDaaat FFF) 

BCFFFFFFFF) 


ERROR. SUCCESS 
4246 (NO,NB,E,BE,NS,PE, GE, LE) 


Figure 1.9: OllyDbg: before printf() execution 


Now the PC points to the CALL printf instruction. OllyDbg, like other debuggers, 
highlights the value of the registers which were changed. So each time you press 
F8, EIP changes and its value is displayed in red. ESP changes as well, because the 
arguments values are pushed into the stack. 


Where are the values in the stack? Take a look at the right bottom debugger window: 


8 RETURN from 1.612F1000 to 1.0 
BOSBCEi9S| MEL 


Figure 1.10: OllyDbg: stack after the argument values have been pushed (The red 
rectangular border was added by the author in a graphics editor) 


We can see 3 columns there: address in the stack, value in the stack and some 
additional OllyDbg comments. OllyDbg can detect pointers to ASCII strings in stack, 
so it reports the printf()-string here. 


It is possible to right-click on the format string, click on "Follow in dump", and the 
format string will appear in the debugger left-bottom window, which always displays 
some part of the memory. These memory values can be edited. It is possible to 
change the format string, in which case the result of our example would be different. 
It is not very useful in this particular case, but it could be good as an exercise so you 
start building a feel of how everything works here. 
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Press F8 (step over). 


We see the following output in the console: 


a=1; b=2; c=3 


Let’s see how the registers and stack state have changed: 


CPU - main thread, module 1 la x| 
T - 


PUSH EBP Registers (FPU) 
A EOR EAX OOBOdOUD o cnocrEao 
ap HE GAScEESS MSUCRI 10. 6ASGEES? 


PUSH 1 z 
PUSH OFFSET B12F3008 f ES E PTR to ASCII "a-zd; bed: c 
dee n at DWORD PTR OS: EL«&HSUCR110.printf?1 a ey ee igi raid 
ADD ESP, 10 
SOR EAX, EAX 
POP EBP TIN 
ca RETN 1.612F1014 
B8 4D5A0999 | MOU EAX, 5A4D C id jt OLFFFFFFFE) 
66:3905 0008 CMP WORD PTR DS:L«STRUCT IMRGE DOS HERDI $ : MS DLEEEEEEEES 
74 04 JE SHORT Ol2F182D D a "EE jit BUFFFFFFFF) 
XOR EAX, EAX 9026 32bit ØLFFFFFFFF) 

L LEL - S8 7EFDDaaat FFF) 


Inm-00000010 (decimal 16.7 $8 OES 0628 Spit g 
ESP=0022F928, PTR to ASCII "a-zd; b-Xd; o=%d" Rae BEFEFFEPEES 


Figure 1.11: OllyDbg after printf() execution 


Register EAX now contains 0xD (13). That is correct, since printf() returns the 
number of characters printed. The value of EIP has changed: indeed, now it contains 
the address of the instruction coming after CALL printf. ECX and EDX values have 
changed as well. Apparently, the printf() function's hidden machinery used them 
for its own needs. 


A very important fact is that neither the ESP value, nor the stack state have been 
changed! We clearly see that the format string and corresponding 3 values are still 
there. This is indeed the cdecl calling convention behavior: callee does not return 
ESP back to its previous value. The caller is responsible to do so. 
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Press F8 again to execute ADD ESP, 10 instruction: 


CPU - main thread, module 1 (Of x| 
PUSH EBP 3 a 
a a . COS ERP. ESP 

PUSH 2 MSUCR118.6R36EE89 


PUSH 1 

PUSH OFFSET 612F3000 

CALL DWORD PTR DS:L4&MSUCR118.printf?1 
ADD ESP, 10 

XOR EAX, EAX 

POP EBP 

RETN 


à 
EIP 012F1017 1.012F1017 
MOU EAX, SA4D cB ESO BLFFFFFFFF) 
5 gaga CHP WORD PTR_DS: [<STRUCT IMRGE DOS HERD ; Bt FFFFFFFF) 
JE SHORT 012F1020 A G BLFFFFFFFF) 
XOR EAX EAX oo o o BCFFFFFFFF) 
UP SHORT G A so FS 7EFDDOBOLFFF) 
@ GS BB2B OCFFFFFFFF) 


LastErr 
68606262 (NO, NB, 
aliaa 


06 60 60 06/61 aao oa oo 
FE FF FF FF|FF FF FF FF 


Figure 1.12: OllyDbg: after ADD ESP, 10 instruction execution 


ESP has changed, but the values are still in the stack! Yes, of course; no one needs to 
set these values to zeros or something like that. Everything above the stack pointer 
(SP) is noise or garbage and has no meaning at all. It would be time consuming to 
clear the unused stack entries anyway, and no one really needs to. 


GCC 


Now let's compile the same program in Linux using GCC 4.4.1 and take a look at 
what we have got in IDA: 


main proc near 

var 10 = dword ptr -10h 

var C = dword ptr -0Ch 

var 8 = dword ptr -8 

var 4 - dword ptr -4 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 10h 
mov eax, offset aADBDCD ; "a=%d; b=%d; c=%d" 
mov [esp+10h+var_4], 3 
mov [esp+10h+var_8], 2 
mov [esp+10h+var_C], 1 
mov [esp+10h+var_10], eax 
call _ printf 
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mov eax, 0 
leave 
retn 

main endp 


Its noticeable that the difference between the MSVC code and the GCC code is only 
in the way the arguments are stored on the stack. Here GCC is working directly with 
the stack without the use of PUSH/POP. 


GCC and GDB 


Let's try this example also in GDB® in Linux. 


-g option instructs the compiler to include debug information in the executable file. 


$ gcc 1.c -g -o 1 


$ gdb 1 
GNU gdb (GDB) 7.6.1-ubuntu 


Reading symbols from /home/dennis/polygon/1...done. 


Listing 1.48: let's set breakpoint on printf() 


(gdb) b printf 
Breakpoint 1 at 0x80482f0 


Run. We don't have the printf() function source code here, so GDB can't show it, 
but may do so. 


(gdb) run 
Starting program: /home/dennis/polygon/1 


Breakpoint 1, _ printf (format=0x80484f0 "a-*d; b-*d; c-*d") at printf.c:29 
29 printf.c: No such file or directory. 


Print 10 stack elements. The most left column contains addresses on the stack. 


(gdb) x/10w $esp 


Oxbffffllc: 0x0804844a 0x080484f0 0x00000001 0x00000002 
Oxbffff12c: 0x00000003 0x08048460 0x00000000 0x00000000 
Oxbffffi3c: 0xb7e29905 0x00000001 


The very first element is the RA (0x0804844a). We can verify this by disassembling 
the memory at this address: 


(gdb) x/5i 0x0804844a 
0x804844a <main+45>: mov $0x0,%eax 
0x804844f <main+50>: leave 
0x8048450 <main+51>: ret 


67GNU Debugger 
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0x8048451: xchg %ax,%ax 
0x8048453: xchg %ax,%ax 


The two XCHG instructions are idle instructions, analogous to NOPs. 
The second element (0x080484f0) is the format string address: 


(gdb) x/s 0x080484f0 
0x80484f0: "a=%d; b=%d; c=%d" 


Next 3 elements (1, 2, 3) are the printf() arguments. The rest of the elements 
could be just “garbage” on the stack, but could also be values from other functions, 
their local variables, etc. We can ignore them for now. 


Run “finish”. The command instructs GDB to “execute all instructions until the end 
of the function". In this case: execute till the end of printf (). 


(gdb) finish 

Run till exit from 40 — printf (format-0x80484f0 "a=%d; b=%d; c=%d") at 2 
y printf.c:29 

main () at 1.c:6 

6 return 0; 

Value returned is $2 - 13 


GDB shows what printf() returned in EAX (13). This is the number of characters 
printed out, just like in the OllyDbg example. 


We also see "return 0;" and the information that this expression is in the 1.c file at 
the line 6. Indeed, the 1.c file is located in the current directory, and GDB finds the 
string there. How does GDB know which C-code line is being currently executed? 
This is due to the fact that the compiler, while generating debugging information, 
also saves a table of relations between source code line numbers and instruction 
addresses. GDB is a source-level debugger, after all. 


Let's examine the registers. 13 in EAX: 


(gdb) info registers 


eax Oxd 13 

ecx 0x0 0 

edx 0x0 0 

ebx 0xb7fc0000 -1208221696 
esp Oxbffff120 Oxbffff120 
ebp Oxbffff138 Oxbffff138 
esi 0x0 0 

edi 0x0 0 


eip 0x804844a 0x804844a <main+45> 


Let's disassemble the current instructions. The arrow points to the instruction to be 
executed next. 


(gdb) disas 
Dump of assembler code for function main: 
0x0804841d <+0>: push X *sebp 
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0x0804841e <+1>: mov *sesp , sebp 
0x08048420 <+3>: and $0xfffffff0,*sesp 
0x08048423 <+6>: sub $0x10,%esp 


0x08048426 <+9>: movl $0x3 ,Oxc(%esp) 

0x0804842e <+17>: movl $0x2 , 0x8 (*sesp) 

0x08048436 <+25>: movl $0x1,0x4 (*sesp) 

0x0804843e «433»: movl $0x80484f0, (%esp) 

0x08048445 <+40>: call 0x80482f0 <printf@plt> 
=> 0x0804844a <+45>: mov $0x0,%eax 

0x0804844f <+50>: leave 

0x08048450 <+51>: ret 


End of assembler dump. 


GDB uses AT&T syntax by default. But it is possible to switch to Intel syntax: 


(gdb) set disassembly-flavor intel 
(gdb) disas 
Dump of assembler code for function main: 


0x0804841d <+0>: push ebp 

0x0804841e <+1>: mov ebp,esp 

0x08048420 «43»: and esp,Oxfffffff0 
0x08048423 <+6>: sub esp, 0x10 

0x08048426 «49»: mov DWORD PTR [esp+0xc] , 0x3 


0x0804842e <+17>: mov 
0x08048436 <+25>: mov 
0x0804843e <+33>: mov 


DWORD PTR [esp+0x8] , 0x2 
DWORD PTR [esp+0x4] , 0x1 
DWORD PTR [esp] ,0x80484f0 


0x08048445 <+40>: call 0x80482f0 <printf@plt> 
=> 0x0804844a <+45>: mov eax, 0x0 

0x0804844f «450»: leave 

0x08048450 «451»: ret 


End of assembler dump. 


Execute next line of C/C++ code. GDB shows ending bracket, meaning, it ends the 
block. 


(gdb) step 
7 $; 


Let's examine the registers after the MOV EAX, 0 instruction execution. Indeed EAX 
is zero at that point. 


(gdb) info registers 


eax 0x0 0 

ecx 0x0 0 

edx 0x0 0 

ebx 0xb7fc0000 -1208221696 

esp Oxbffff120 Oxbffff120 

ebp Oxbffff138 Oxbffff138 

esi 0x0 0 

edi 0x0 0 

eip 0x804844f 0x804844f <main+50> 
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x64: 8 integer arguments 


To see how other arguments are passed via the stack, let's change our example 
again by increasing the number of arguments to 9 (printf() format string + 8 int 
variables): 


#include <stdio.h> 


int main() 
{ 
printf("a=%d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%sd\n", 1, 2, 3,2 
G 4, 5, 6, 7, 8); 
return 0; 


i 


MSVC 


As it was mentioned earlier, the first 4 arguments has to be passed through the RCX, 
RDX, R8, R9 registers in Win64, while all the rest—via the stack. That is exactly what 
we see here. However, the MOV instruction, instead of PUSH, is used for preparing 
the stack, so the values are stored to the stack in a straightforward manner. 


Listing 1.49: MSVC 2012 x64 


$5G2923 DB 'a-*sd; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%d', OaH, 00H 
main PROC 
sub rsp, 88 
mov DWORD PTR [rsp+64], 8 
mov DWORD PTR [rsp+56], 7 
mov DWORD PTR [rsp+48], 6 
mov DWORD PTR [rsp+40], 5 
mov DWORD PTR [rsp+32], 4 
mov rod, 3 
mov r8d, 2 
mov edx, 1 
lea rcx, OFFSET FLAT: $SG2923 
call printf 
; return 0 
xor eax, eax 
add rsp, 88 
ret 0 
main ENDP 
_TEXT ENDS 
END 


The observant reader may ask why are 8 bytes allocated for int values, when 4 is 
enough? Yes, one has to recall: 8 bytes are allocated for any data type shorter than 
64 bits. This is established for the convenience's sake: it makes it easy to calculate 
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the address of arbitrary argument. Besides, they are all located at aligned memory 
addresses. It is the same in the 32-bit environments: 4 bytes are reserved for all 
data types. 


GCC 


The picture is similar for x86-64 *NIX OS-es, except that the first 6 arguments are 
passed through the RDI, RSI, RDX, RCX, R8, R9 registers. All the rest—via the stack. 
GCC generates the code storing the string pointer into EDI instead of RDI—we noted 
that previously: 1.5.2 on page 21. 


We also noted earlier that the EAX register has been cleared before a printf() call: 
1.5.2 on page 21. 


Listing 1.50: Optimizing GCC 4.4.6 x64 


.LC0: 
.string "a-*d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%d\n" 
main: 
sub rsp, 40 
mov r9d, 5 
mov rad, 4 
mov ecx, 3 
mov edx, 2 
mov esi, 1 
mov edi, OFFSET FLAT: .LCO 
xor eax, eax ; number of vector registers passed 
mov DWORD PTR [rsp+16], 8 
mov DWORD PTR [rsp+8], 7 
mov DWORD PTR [rsp], 6 
call printf 
; return 0 
xor eax, eax 
add rsp, 40 
ret 
GCC + GDB 


Let’s try this example in GDB. 


$ gcc -g 2.c -0 2 


$ gdb 2 
GNU gdb (GDB) 7.6.1-ubuntu 


Reading symbols from /home/dennis/polygon/2...done. 
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Listing 1.51: let's set the breakpoint to printf(), and run 


(gdb) b printf 

Breakpoint 1 at 0x400410 

(gdb) run 

Starting program: /home/dennis/polygon/2 
Breakpoint 1, _ printf (format=0x400628 "a=%d; 
VS ; g=%d; h=%d\n") at printf.c:29 


29 printf.c: No such file or directory. 


Registers RSI/RDX/RCX/R8/R9 have the expected values. RIP has the address of the 
very first instruction of the printf() function. 


(gdb) info registers 


rax 0x0 0 

rbx 0x0 0 

rcx 0x3 3 

rdx 0x2 2 

rsi 0x1 1 

rdi 0x400628 4195880 

rbp Ox7fffffffdfé60 Ox7fffffffdf60 
rsp Ox7fffffffdf38 Ox7fffffffdf38 
r8 0x4 4 

r9 0x5 5 

r10 Ox7fffffffdceO 140737488346336 
r11 Ox7ffff7a65f60 140737348263776 
r12 0x400440 4195392 

r13 Ox7fffffffeO040 140737488347200 
r14 0x0 0 

r15 0x0 0 

rip Ox7ffff7a65f60 Ox7ffff7a65f60 « printf> 


Listing 1.52: let's inspect the format string 


(gdb) x/s $rdi 


0x400628: "a-*sd; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%d\n" 


Let’s dump the stack with the x/g command this time—g stands for giant words, i.e., 
64-bit words. 


(gdb) x/10g $rsp 


Ox7fffffffdf38: 0x0000000000400576 0x0000000000000006 
Ox7fffffffdf48: 0x0000000000000007 0x00007fff900000008 
Ox7fffffffdf58: 0x0000000000000000 0x0000000000000000 
Ox7fffffffdf68: 0x00007ffff7a33de5 0x0000000000000000 
Ox7fffffffdf78: 0x00007fffffffeO048 0x0000000100000000 


The very first stack element, just like in the previous case, is the RA. 3 values are 
also passed through the stack: 6, 7, 8. We also see that 8 is passed with the high 
32-bits not cleared: 0x00007fff00000008. That's OK, because the values are of 
int type, which is 32-bit. So, the high register or stack element part may contain 
"random garbage". 
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If you take a look at where the control will return after the printf() execution, GDB 
will show the entire main() function: 


(gdb) set disassembly-flavor intel 
(gdb) disas 0x0000000000400576 
Dump of assembler code for function main: 


0x000000000040052d «40»: push rbp 

0x000000000040052e <+1>: mov rbp,rsp 
0x0000000000400531 <+4>: sub rsp,0x20 
0x0000000000400535 <+8>: mov DWORD PTR [rsp+0x10],0x8 


0x000000000040053d <+16>: mov DWORD PTR [rsp+0x8],0x7 
0x0000000000400545 <+24>: mov DWORD PTR [rsp],0x6 
0x000000000040054c <+31>: mov r9d,0x5 
0x0000000000400552 <+37>: mov r8d,0x4 
0x0000000000400558 <+43>: mov ecx, 0x3 
0x000000000040055d «448»: mov edx, 0x2 
0x0000000000400562 «453»: mov esi,0x1 
0x0000000000400567 «458»: mov edi,0x400628 
0x000000000040056c «463»: mov eax, 0x0 


0x0000000000400571 <+68>: call 0x400410 <printf@plt> 
0x0000000000400576 «473»: mov eax,0x0 
0x000000000040057b «478»: leave 

0x000000000040057c «479»: ret 


End of assembler dump. 


Let's finish executing printf(), execute the instruction zeroing EAX, and note that 
the EAX register has a value of exactly zero. RIP now points to the LEAVE instruction, 
i.e., the penultimate one in the main() function. 


(gdb) finish 
Run till exit from #0 | printf (format=0x400628 "a=%d; b-*sd; c=%d; d-*d; ez 
V =%d; f=%d; g=%d; h=%d\n") at printf.c:29 


a-1; b=2; c=3; d=4; e=5; f=6; g=7; h=8 

main () at 2.c:6 

6 return 0; 

Value returned is $1 = 39 

(gdb) next 

7 un 

(gdb) info registers 

rax 0x0 0 

rbx 0x0 0 

rcx 0x26 38 

rdx Ox7ffff7dd59f0 140737351866864 
rsi Ox7fffffd9 2147483609 

rdi 0x0 0 

rbp Ox7fffffffdf60 Ox7fffffffdf60 
rsp Ox7fffffffdf40 Ox7fffffffdf40 
r8 Ox7ffff7dd26a0 140737351853728 
r9 Ox7ffff7a60134 140737348239668 
r10 Ox7fffffffd5bO 140737488344496 
r11 0x7ffff7a95900 140737348458752 
r12 0x400440 4195392 

r13 Ox7fffffffe040 140737488347200 
r14 0x0 0 
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r15 0x0 0 
rip 0x40057b 0x40057b <main+78> 
1.11.2 ARM 


ARM: 3 integer arguments 


ARM's traditional scheme for passing arguments (calling convention) behaves as fol- 
lows: the first 4 arguments are passed through the RO-R3 registers; the remaining 
arguments via the stack. This resembles the arguments passing scheme in fast- 
call (6.1.3 on page 934) or win64 (6.1.5 on page 936). 


32-bit ARM 


Non-optimizing Keil 6/2013 (ARM mode) 


Listing 1.53: Non-optimizing Keil 6/2013 (ARM mode) 


.text:00000000 main 
.text:00000000 10 40 2D E9 STMFD  SP!, {R4,LR} 


.text:00000004 03 30 AO E3 MOV R3, 43 

.text:00000008 02 20 AO E3 MOV R2, 42 

.text:0000000C 01 10 AO E3 MOV R1, #1 

.text:00000010 08 00 8F E2 ADR RO, aADBDCD ; "a=%d; b=%d; c=%d" 
.text:00000014 06 00 00 EB BL _ 2printf 

.text:00000018 00 00 AO E3 MOV RO, 40 ; return 0 


.text:0000001C 10 80 BD E8  LDMFD SP!, {R4,PC} 


So, the first 4 arguments are passed via the RO-R3 registers in this order: a pointer 
to the printf() format string in RO, then 1 in R1, 2 in R2 and 3 in R3. The instruction 
at 0x18 writes 0 to RO—this is return O C-statement. There is nothing unusual so far. 


Optimizing Keil 6/2013 generates the same code. 


Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.54: Optimizing Keil 6/2013 (Thumb mode) 


.text:00000000 main 


.text:00000000 10 B5 PUSH {R4,LR} 

. text: 00000002 03 23 MOVS R3, #3 

. text: 00000004 02 22 MOVS R2, #2 

. text: 00000006 01 21 MOVS R1, #1 

. text: 00000008 02 AO ADR RO, aADBDCD ; "a=%d; b=%d; c=%d" 
.text:0000000A 00 FO OD F8 BL . 2printf 

.text:0000000E 00 20 MOVS RO, #0 

.text:00000010 10 BD POP {R4,PC} 
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There is no significant difference from the non-optimized code for ARM mode. 
Optimizing Keil 6/2013 (ARM mode) - let's remove return 


Let's rework example slightly by removing return 0: 


#include <stdio.h> 


void main() 


{ 
J; 


printf ("a=%d; b=%d; c=%d", 1, 2, 3); 


The result is somewhat unusual: 


Listing 1.55: Optimizing Keil 6/2013 (ARM mode) 


.text:00000014 main 


.text:00000014 03 30 AO E3 MOV R3, #3 

.text:00000018 02 20 A0 E3 MOV R2, #2 

.text:0000001C 01 10 AO E3 MOV R1, #1 

.text:00000020 1E OE 8F E2 ADR RO, aADBDCD ; 'a-*d; b=%d; c=%d\n" 
.text:00000024 CB 18 00 EA B . 2printf 


This is the optimized (-03) version for ARM mode and this time we see B as the 
last instruction instead of the familiar BL. Another difference between this optimized 
version and the previous one (compiled without optimization) is the lack of function 
prologue and epilogue (instructions preserving the RO and LR registers values). The 
B instruction just jumps to another address, without any manipulation of the LR regis- 
ter, similar to JMP in x86. Why does it work? Because this code is, in fact, effectively 
equivalent to the previous. There are two main reasons: 1) neither the stack nor 
SP (the stack pointer) is modified; 2) the call to printf() is the last instruction, so 
there is nothing going on afterwards. On completion, the printf() function sim- 
ply returns the control to the address stored in LR. Since the LR currently stores 
the address of the point from where our function has been called then the control 
from printf() will be returned to that point. Therefore we do not have to save LR 
because we do not have necessity to modify LR. And we do not have necessity to 
modify LR because there are no other function calls except printf(). Furthermore, 
after this call we do not to do anything else! That is the reason such optimization is 
possible. 


This optimization is often used in functions where the last statement is a call to 
another function. A similar example is presented here: 1.21.1 on page 198. 


A somewhat simpler case was described above: 1.10 on page 55. 


ARM64 
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Non-optimizing GCC (Linaro) 4.9 


Listing 1.56: Non-optimizing GCC (Linaro) 4.9 


.LC1: 
.string "a=%d; b-*sd; c=%d" 
f2: 
; save FP and LR in stack frame: 
stp x29, x30, [sp, -16]! 
; set stack frame (FP=SP): 
add x29, sp, 0 
adrp x0, .LC1 
add x0, x0, :lo12:.LC1 
mov wl, 1 
mov w2, 2 
mov w3, 3 
bl printf 
mov w0, 0 
; restore FP and LR 
ldp x29, x30, [sp], 16 
ret 


The first instruction STP (Store Pair) saves FP (X29) and LR (X30) in the stack. The 
second ADD X29, SP, Oinstruction forms the stack frame. It is just writing the value 
of SP into X29. 


Next, we see the familiar ADRP/ADD instruction pair, which forms a pointer to the 
string. lo12 meaning low 12 bits, i.e., linker will write low 12 bits of LC1 address into 
the opcode of ADD instruction. 1, 2 and 3 are 32-bit int values, so they are loaded 
into 32-bit register parts 9? 


Optimizing GCC (Linaro) 4.9 generates the same code. 


ARM: 8 integer arguments 


Let's use again the example with 9 arguments from the previous section: 1.11.1 on 
page 66. 


#include <stdio.h> 


int main() 
{ 
printf("a=%d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%sd\n", 1, 2, 3,2 
G 4, 5; 6, 7, 8); 
return 0; 


68Changing 1 to 1L will make it a 64-bit value that would be loaded into 64-bit register. See more about 
integer constants/literals: 1, 2. 
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Optimizing Keil 6/2013: ARM mode 


.text:00000028 main 
.text:00000028 

.text:00000028 var 18 - -0x18 
.text:00000028 var 14 = -0x14 
.text:00000028 var 4 = -4 


.text:00000028 

.text:00000028 04 EO 2D E5 STR LR, [SP,Zvar 4]! 

.text:0000002C 14 DO 4D E2 SUB SP, SP, 40x14 

.text:00000030 08 30 AO E3 MOV R3, #8 

.text:00000034 07 20 AO E3 MOV R2, #7 

.text:00000038 06 10 AO E3 MOV R1, £6 

.text:0000003C 05 00 AO E3 MOV RO, #5 

.text:00000040 04 CO 8D E2 ADD R12, SP, #0x18+var_14 

.text:00000044 OF 00 8C EB STMIA R12, {RO-R3} 

.text:00000048 04 00 AO E3 MOV RO, #4 

.text:0000004C 00 00 8D E5 STR RO, [SP,#0x18+var_18] 

.text:00000050 03 30 AO E3 MOV R3, #3 

.text:00000054 02 20 AO E3 MOV R2, 42 

.text:00000058 01 10 AO E3 MOV R1, #1 

.text:0000005C 6E OF 8F E2 ADR RO, aADBDCDDDEDFDGD ; "a=%d; b=%d; c=%d; 
d=%d; e=%d; f-*d; g=%"... 

. text: 00000060 BC 18 00 EB BL . 2printf 

.text:00000064 14 DO 8D E2 ADD SP, SP, 40x14 

.text:00000068 04 FO 9D E4 LDR PC, [SP+4+var_4],#4 


This code can be divided into several parts: 
* Function prologue: 


The very first STR LR, [SP,#var 4]! instruction saves LR on the stack, be- 
cause we are going to use this register for the printf() call. Exclamation 
mark at the end indicates pre-index. 


This implies that SP is to be decreased by 4 first, and then LR will be saved at 
the address stored in SP. This is similar to PUSH in x86. Read more about it at: 
1.39.2 on page 555. 


The second SUB SP, SP, £0x14 instruction decreases SP (the stack pointer) in 
order to allocate 0x14 (20) bytes on the stack. Indeed, we have to pass 5 32-bit 
values via the stack to the printf() function, and each one occupies 4 bytes, 
which is exactly 5 + 4 = 20. The other 4 32-bit values are to be passed through 
registers. 


Passing 5, 6, 7 and 8 via the stack: they are stored in the RO, R1, R2 and R3 
registers respectively. 

Then, the ADD R12, SP, #0x18+var_14 instruction writes the stack address 
where these 4 variables are to be stored, into the R12 register. var 14 is an 
assembly macro, equal to -0x14, created by IDA to conveniently display the 
code accessing the stack. The var ? macros generated by IDA reflect local 
variables in the stack. 
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So, SP+4 is to be stored into the R12 register. 

The next STMIA R12, RO-R3 instruction writes registers RO-R3 contents to the 
memory pointed by R12. STMIA abbreviates Store Multiple Increment After. In- 
crement After implies that R12 is to be increased by 4 after each register value 
is written. 


Passing 4 via the stack: 4 is stored in RO and then this value, with the help of 
the 

STR RO, [SP,#0x18+var_18] instruction is saved on the stack. var. 18 is -0x18, 
so the offset is to be O, thus the value from the RO register (4) is to be written 
to the address written in SP. 


Passing 1, 2 and 3 via registers: The values of the first 3 numbers (a, b, c) (1, 
2, 3 respectively) are passed through the R1, R2 and R3 registers right before 
the printf() call. 


printf() call. 


Function epilogue: 


The ADD SP, SP, #0x14 instruction restores the SP pointer back to its former 
value, thus annulling everything what has been stored on the stack. Of course, 
what has been stored on the stack will stay there, but it will all be rewritten 
during the execution of subsequent functions. 


The LDR PC, [SP+4+var_ 4],24 instruction loads the saved LR value from the 
stack into the PC register, thus causing the function to exit. There is no exclama- 
tion mark—indeed, PC is loaded first from the address stored in SP (4+ var 4— 
4 + (-4) = 0), so this instruction is analogous to LDR PC, [SP],#4), and then 
SP is increased by 4. This is referred as post-index9?. Why does IDA display 
the instruction like that? Because it wants to illustrate the stack layout and 
the fact that var 4 is allocated for saving the LR value in the local stack. This 
instruction is somewhat similar to POP PC in x86". 


Optimizing Keil 6/2013: Thumb mode 


.text:0000001C printf main2 

.text:0000001C 

.text:0000001C var 18 - -0x18 

.text:0000001C var 14 = -0x14 

.text:0000001C var 8 = -8 

.text:0000001C 

.text:0000001C 00 B5 PUSH {LR} 

. text: 0000001E 08 23 MOVS R3, #8 

. text: 00000020 85 BO SUB SP, SP, #0x14 
.text:00000022 04 93 STR R3, [SP,#0x18+var 8] 
. text: 00000024 07 22 MOVS R2, #7 

. text: 00000026 06 21 MOVS R1, #6 

. text: 00000028 05 20 MOVS RO, #5 
.text:0000002A 01 AB ADD R3, SP, #0x18+var_14 


$9Read more about it: 1.39.2 on page 555. 
70It is impossible to set IP/EIP/RIP value using POP in x86, but anyway, you got the analogy right. 
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.text:0000002C 07 C3 STMIA  R3!, {RO-R2} 

.text:0000002E 04 20 MOVS RO, #4 

.text:00000030 00 90 STR RO, [SP,£0x18-var 18] 

.text:00000032 03 23 MOVS R3, 43 

.text:00000034 02 22 MOVS R2, 42 

.text:00000036 01 21 MOVS R1, #1 

.text:00000038 AO AO ADR RO, aADBDCDDDEDFDGD ; "a=%d; b=%d; c=%d; 
d=%d; e=%d; f=%d; g=%"... 

. text: 0000003A 06 FO Da F8 BL _ 2printf 

.text:0000003E 

.text:0000003E loc 3E ; CODE XREF: examplel3 f+16 

.text:0000003E 05 BO ADD SP, SP, 40x14 

.text:00000040 00 BD POP {PC} 


The output is almost like in the previous example. However, this is Thumb code and 
the values are packed into stack differently: 8 goes first, then 5, 6, 7, and 4 goes 
third. 


Optimizing Xcode 4.6.3 (LLVM): ARM mode 


. text:0000290C | printf main2 
_ text:0000290C 

. text:0000290C var 1C = -0x1C 
. text:0000290C var C = -0xC 


_ text:0000290C 

. text:0000290C 80 40 2D E9 STMFD SP!, {R7,LR} 

. text:00002910 OD 70 AO El MOV R7, SP 

. text:00002914 14 DO 4D E2 SUB SP, SP, 40x14 

. text:00002918 70 05 01 E3 MOV RO, #0x1570 

. text:0000291C 07 CO A0 E3 MOV R12, #7 

. text:00002920 00 00 40 E3  MOVT RO, #0 

. text:00002924 04 20 A0 E3 MOV R2, #4 

. text:00002928 00 00 8F EO ADD RO, PC, RO 

. text:0000292C 06 30 A0 E3 MOV R3, #6 

. text:00002930 05 10 A0 E3 MOV R1, #5 

. text:00002934 00 20 8D E5 STR R2, [SP,#0x1C+var_1C] 
. text:00002938 0A 10 8D E9 STMFA SP, {R1,R3,R12} 
. text:0000293C 08 90 AO E3 MOV R9, #8 

. text:00002940 01 10 A0 E3 MOV R1, 41 

. text:00002944 02 20 A0 E3 MOV R2, #2 

. text:00002948 03 30 A0 E3 MOV R3, #3 

. text:0000294C 10 90 8D E5 STR R9, [SP,#0x1C+var_C] 
. text:00002950 A4 05 00 EB BL | printf 

. text:00002954 07 DO AO El MOV SP, R7 

. text:00002958 80 80 BD E8  LDMFD SP!, {R7,PC} 


Almost the same as what we have already seen, with the exception of STMFA (Store 
Multiple Full Ascending) instruction, which is a synonym of STMIB (Store Multiple 
Increment Before) instruction. This instruction increases the value in the SP register 
and only then writes the next register value into the memory, rather than performing 
those two actions in the opposite order. 
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Another thing that catches the eye is that the instructions are arranged seemingly 
random. For example, the value in the RO register is manipulated in three places, 
at addresses 0x2918, 0x2920 and 0x2928, when it would be possible to do it in one 
point. 


However, the optimizing compiler may have its own reasons on how to order the 
instructions so to achieve higher efficiency during the execution. 


Usually, the processor attempts to simultaneously execute instructions located side- 
by-side. 

For example, instructions like MOVT RO, #0 and ADD RO, PC, RO cannot be exe- 
cuted simultaneously since they both modify the RO register. On the other hand, 
MOVT RO, #0 and MOV R2, #4 instructions can be executed simultaneously since 
the effects of their execution are not conflicting with each other. Presumably, the 
compiler tries to generate code in such a manner (wherever it is possible). 


Optimizing Xcode 4.6.3 (LLVM): Thumb-2 mode 


_ text:00002BA0 | printf main2 

_ text:00002BA0 

_ text:00002BA0 var 1C = -0x1C 

_ text:00002BA0 var 18 - -0x18 

_ text:00002BA0 var C = -0xC 

_ text:00002BA0 

. text:00002BA0 80 B5 PUSH {R7,LR} 

. text:00002BA2 6F 46 MOV R7, SP 
__text:00002BA4 85 BO SUB SP, SP, #0x14 
. text:00002BA6 41 F2 D8 20 MOVW RO, #0x12D8 


. text:00002BAA 4F FO 07 OC MOV.W R12, #7 
. text:00002BAE CO F2 00 00 MOVT.W RO, £0 


_ text:00002BB2 04 22 MOVS R2, #4 

. text:00002BBA 78 44 ADD RO, PC ; char * 

. text:00002BB6 06 23 MOVS R3, #6 

_ text:00002BB8 05 21 MOVS R1, 45 

. text:00002BBA OD F1 04 OE ADD.W LR, SP, #0x1C+var_18 
. text:00002BBE 00 92 STR R2, [SP,£0x1C-var 1C] 


. text:00002BCO 4F FO 08 09 MOV.W R9, #8 
. text:00002BCA 8E E8 0A 10 STMIA.W LR, {R1,R3,R12} 


. text:00002BC8 01 21 MOVS R1, #1 

. text:00002BCA 02 22 MOVS R2, #2 

_ text:00002BCC 03 23 MOVS R3, 43 

. text:00002BCE CD F8 10 90 STR.W R9, [SP,#0x1C+var C] 
. text:00002BD2 01 FO OA EA BLX | printf 

. text:00002BD6 05 BO ADD SP, SP, 40x14 

_ text:00002BD8 80 BD POP {R7,PC} 


The output is almost the same as in the previous example, with the exception that 
Thumb/Thumb 2-instructions are used instead. 


ARM64 
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Non-optimizing GCC (Linaro) 4.9 


Listing 1.57: Non-optimizing GCC (Linaro) 4.9 


.LC2: 
.string "a-*d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%d\n" 
f3: 
; grab more space in stack: 
sub sp, sp, #32 
; save FP and LR in stack frame: 
stp x29, x30, [sp,16] 
; set frame pointer (FP=SP+16): 
add x29, sp, 16 
adrp X0, .LC2 ; "a=%d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%sd\n" 
add x0, x0, :lo12:.LC2 
mov wl, 8 ; 9th argument 
str w1, [sp] ; store 9th argument in the stack 
mov wl, 1 
mov w2, 2 
mov w3, 3 
mov w4, 4 
mov w5, 5 
mov w6, 6 
mov w7, 7 
bl printf 
sub sp, x29, £16 
; restore FP and LR 
ldp x29, x30, [sp,16] 
add sp, sp, 32 
ret 


The first 8 arguments are passed in X- or W-registers: [Procedure Call Standard for 
the ARM 64-bit Architecture (AArch64), (2013)]/!. A string pointer requires a 64-bit 
register, so it's passed in X0. All other values have a int 32-bit type, so they are 
stored in the 32-bit part of the registers (W-). The 9th argument (8) is passed via the 
stack. Indeed: it's not possible to pass large number of arguments through registers, 
because the number of registers is limited. 


Optimizing GCC (Linaro) 4.9 generates the same code. 


1.11.3 MIPS 
3 integer arguments 
Optimizing GCC 4.4.5 


The main difference with the "Hello, world!" example is that in this case printf() 
is called instead of puts() and 3 more arguments are passed through the registers 


“Also available as http://infocenter.arm.com/help/topic/com.arm.doc.ihi0055b/IHI0055B _ 
aapcs64.pdf 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


78 
$5...$7 (or $A1...$A3). That is why these registers are prefixed with A-, which implies 
they are used for function arguments passing. 


Listing 1.58: Optimizing GCC 4.4.5 (assembly output) 


$LCO: 
.ascii  "a-*sd; b=%d; c=%d\000" 
main: 
; function prologue: 
lui $28,%hi(_ gnu local gp) 
addiu — $sp,$sp,-32 
addiu | $28, $28,%lo(__ gnu_local_gp) 
SW $31,28($sp) 
; load address of printf(): 
lw $25 ,%call16 (printf) ($28) 
; load address of the text string and set 1st argument of printf(): 
lui $4,%hi($LC0) 


addiu $4,$4,%lo($LC0) 
; set 2nd argument of printf(): 


li $5,1 # 0x1 
; set 3rd argument of printf(): 

li $6,2 # 0x2 
; call printf(): 

jalr $25 
; set 4th argument of printf() (branch delay slot): 

li $7,3 # 0x3 
; function epilogue: 

lw $31,28($sp) 
; Set return value to 0: 

move $2,$0 
; return 

j $31 


addiu $sp,$sp,32 ; branch delay slot 


Listing 1.59: Optimizing GCC 4.4.5 (IDA) 


.text:00000000 main: 
.text:00000000 


.text:00000000 var 10 - -0x10 

.text:00000000 var 4 = -4 

. text: 00000000 

; function prologue: 

. text: 00000000 lui $gp, ( gnu local gp >> 16) 
.text:00000004 addiu  $sp, -0x20 

. text: 00000008 la $gp, (. gnu local gp € OxFFFF) 
.text:0000000C SW $ra, 0x20+var_4($sp) 
.text:00000010 SW $gp, 0x20«var 10($sp) 

; load address of printf(): 

.text:00000014 lw $t9, (printf € OxFFFF) ($gp) 

; load address of the text string and set 1st argument of printf(): 
.text:00000018 la $a0, $LCO # "a-*d; b=%d; c=%d" 
; set 2nd argument of printf(): 

. text: 00000020 li $al, 1 
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; set 3rd argument of printf(): 


.text:00000024 li 

; call printf(): 

.text:00000028 jalr 
; set 4th argument of printf() (branch 
. text: 0000002C li 

; function epilogue: 

. text : 00000030 lw 

; set return value to 0: 
.text:00000034 move 
; return 

.text:00000038 jr 

. text: 0000003C addiu 


$a2, 2 

$t9 

delay slot): 

$a3, 3 

$ra, 0x20+var_4($sp) 


$vO, $zero 


$ra 
$sp, 0x20 ; branch delay slot 


IDA has coalesced pair of LUI and ADDIU instructions into one LA pseudo instruction. 


That's why there are no instruction at add 
Non-optimizing GCC 4.4.5 


Non-optimizing GCC is more verbose: 


ress Ox1C: because LA occupies 8 bytes. 


Listing 1.60: Non-optimizing GCC 4.4.5 (assembly output) 


$LCO: 
.ascii "a=%d; b=%d; c=%d\000" 
main: 
; function prologue: 
addiu  $sp,$sp,-32 
SW $31,28($sp) 
SW $fp,24($sp) 
move $fp,$sp 
lui $28,9shi( gnu local gp) 
addiu  $28,$28,%lo(_ gnu local gp) 
; load address of the text string: 
lui $2,%hi($LCO) 
addiu $2,$2,%lo($LCO) 
; set 1st argument of printf(): 
move $4, $2 
; set 2nd argument of printf(): 
li $5,1 # 0x1 
; set 3rd argument of printf(): 
li $6,2 # 0x2 
; set 4th argument of printf(): 
li $7,3 # 0x3 


get address of printf(): 


lw $2,%call16(printf) ($28) 
nop 
; call printf(): 
move $25,$2 
jalr $25 
nop 
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; function epilogue: 


lw $28,16($fp) 
; set return value to 0: 

move $2,$0 

move $sp,$fp 

lw $31,28($sp) 

lw $fp,24($sp) 

addiu _ $sp,$sp,32 
; return 

j $31 

nop 

Listing 1.61: Non-optimizing GCC 4.4.5 (IDA) 

.text:00000000 main: 
.text:00000000 
.text:00000000 var 10 = -0x10 
.text:00000000 var 8 = -8 
.text:00000000 var 4 = -4 
. text: 00000000 
; function prologue: 
. text: 00000000 addiu $sp, -0x20 
.text:00000004 SW $ra, 0x20+var_4($sp) 
.text:00000008 SW $fp, 0x20+var_8($sp) 
.text:0000000C move $fp, $sp 
.text:00000010 la $gp, gnu local gp 
.text:00000018 SW $gp, 0x20+var_10($sp) 
; load address of the text string: 
.text:0000001C la $v0, aADBDCD # "a=%d; b=%d; c=%d" 
; set 1st argument of printf(): 
. text: 00000024 move $a0, $v0 
; set 2nd argument of printf(): 
. text: 00000028 li $al, 1 
; set 3rd argument of printf(): 
. text: 0000002C li $a2, 2 
; set 4th argument of printf(): 
. text: 00000030 li $a3, 3 
; get address of printf(): 
. text: 00000034 lw $v0, (printf € OxFFFF) ($gp) 
. text : 00000038 or gat, $zero 
; call printf(): 
. text: 0000003C move $t9, $v0 
.text:00000040 jalr $t9 
.text:00000044 or $at, $zero ; NOP 
; function epilogue: 
.text:00000048 lw $gp, 0x20+var_10($fp) 
; set return value to 0: 
.text:0000004C move $v0, $zero 
.text:00000050 move $sp, $fp 
.text:00000054 lw $ra, 0x20+var_4($sp) 
.text:00000058 lw $fp, 0x20-var 8($sp) 
.text:0000005C addiu $sp, 0x20 
; return 
.text:00000060 jr $ra 
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.text:00000064 or $at, $zero ; NOP 


8 integer arguments 


Let's use again the example with 9 arguments from the previous section: 1.11.1 on 
page 66. 


#include <stdio.h> 


int main() 
{ 
printf("a=%d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%sd\n", 1, 2, 3,27 
S 4, 5, 6, 7, 8); 
return 0; 


i 


Optimizing GCC 4.4.5 


Only the first 4 arguments are passed in the $A0 ...$A3 registers, the rest are passed 
via the stack. 


This is the O32 calling convention (which is the most common one in the MIPS world). 
Other calling conventions, or manually written assembly code, may use the registers 
for different purposes. 


SW abbreviates "Store Word" (from register to memory). MIPS lacks instructions for 
storing a value into memory, so an instruction pair has to be used instead (LI/SW). 


Listing 1.62: Optimizing GCC 4.4.5 (assembly output) 


$LCO: 
.ascii  "a-*d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%d\012\000" 
main: 
; function prologue: 
lui $28,9shi( gnu local gp) 
addiu  $sp,$sp,-56 
addiu  $28,$28,%lo(_ gnu local gp) 
sw $31,52($5p) 
; pass 5th argument in stack: 
li $2,4 # 0x4 
SW $2,16($sp) 
; pass 6th argument in stack: 
li $2,5 # 0x5 
sw $2,20($5p) 
; pass 7th argument in stack: 
li $2,6 # 0x6 
SW $2,24($sp) 
; pass 8th argument in stack: 
li $2,7 # 0x7 
lw $25 ,%call16 (printf) ($28) 
SW $2,28($sp) 
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; pass 1st argument in $a0: 


lui $4,*shi($LCO) 

; pass 9th argument in stack: 
li $2,8 # 0x8 
SW $2,32($sp) 


addiu $4,$4,%lo($LC0) 
; pass 2nd argument in $al: 


li $5,1 # 0x1 
; pass 3rd argument in $a2: 

li $6,2 # 0x2 
; call printf(): 

jalr $25 
; pass 4th argument in $a3 (branch delay slot): 

li $7,3 # 0x3 
; function epilogue: 

lw $31,52($sp) 
; set return value to 0: 

move $2,$0 
; return 

j $31 


addiu  $sp,$sp,56 ; branch delay slot 


Listing 1.63: Optimizing GCC 4.4.5 (IDA) 


.text:00000000 main: 
.text:00000000 


.text:00000000 var 28 = -0x28 

.text:00000000 var 24 = -0x24 

.text:00000000 var 20 - -0x20 

.text:00000000 var 1C = -0x1C 

.text:00000000 var 18 = -0x18 

.text:00000000 var 10 = -0x10 

.text:00000000 var 4 = -4 

. text: 00000000 

; function prologue: 

. text: 00000000 lui $gp, ( gnu local gp >> 16) 
.text:00000004 addiu $sp, -0x38 

.text:00000008 la $gp, (gnu local gp € OxFFFF) 
.text:0000000C SW $ra, 0x38+var_4($sp) 

. text: 00000010 SW $gp, 0x38+var_10($5p) 

; pass 5th argument in stack: 

.text:00000014 li $v0, 4 

.text:00000018 SW $v0, 0x38-var 28($sp) 

; pass 6th argument in stack: 

.text:0000001C li $v0, 5 

.text:00000020 SW $v0, Ox38+var_24($sp) 

; pass 7th argument in stack: 

. text: 00000024 li $v0, 6 

.text:00000028 SW $v0, 0x38+var_20($sp) 

; pass 8th argument in stack: 

. text : 0000002C li $v0, 7 

. text: 00000030 lw $t9, (printf & OxFFFF) ($gp) 
. text: 00000034 SW $v0, Ox38+var_1C($sp) 
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; prepare 1st argument in $20: 

.text:00000038 lui $a0, ($LCO >> 16) # "a=%d; b=%d; 
c=%d; d=%d; e=%d; f=%d; g=%"... 

; pass 9th argument in stack: 


.text:0000003C li $v0, 8 

.text:00000040 SW $v0, 0x38+var_18($5p) 

; pass 1st argument in $a0: 

.text:00000044 la $a0, ($LCO & OxFFFF) # “a=%d; b=%d; 


c=%d; d=%d; e=%d; f=%d; g=%"... 
; pass 2nd argument in $al: 


.text:00000048 li $al, 1 

; pass 3rd argument in $a2: 

.text:0000004C li $a2, 2 

; call printf(): 

.text:00000050 jalr $t9 

; pass 4th argument in $a3 (branch delay slot): 
.text:00000054 li $a3, 3 

; function epilogue: 

.text:00000058 lw $ra, Ox38+var_4($sp) 
; set return value to 0: 

.text:0000005C move $v0, $zero 

; return 

.text:00000060 jr $ra 

. text : 00000064 addiu  $sp, 0x38 ; branch delay slot 


Non-optimizing GCC 4.4.5 


Non-optimizing GCC is more verbose: 


Listing 1.64: Non-optimizing GCC 4.4.5 (assembly output) 


$LCO: 

.ascii  "a-*d; b=%d; c=%d; d=%d; e=%d; f=%d; g=%d; h=%d\012\000" 
main: 
; function prologue: 

addiu $sp,$sp,-56 


SW $31,52($sp) 

SW $fp,48($sp) 

move $fp,$sp 

lui $28,%hi( gnu local gp) 
addiu  $28,$28,%lo(_ gnu_local_gp) 
lui $2,%hi($LCO) 


addiu = $2, $2, %lo($LC0) 


; pass 5th argument in stack: 
li $3,4 # 0x4 
SW $3,16($sp) 

; pass 6th argument in stack: 
li $3,5 # 0x5 
SW $3,20($sp) 

; pass 7th argument in stack: 
li $3,6 # 0x6 
SW $3,24($sp) 

; pass 8th argument in stack: 
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li $3,7 # 0x7 
sw $3,28($sp) 

; pass 9th argument in stack: 
li $3,8 # 0x8 
sw $3,32($sp) 


; pass 1st argument in $a0: 
move $4,$2 
; pass 2nd argument in $al: 


li $5,1 # 0x1 
; pass 3rd argument in $a2: 

li $6,2 # 0x2 
; pass 4th argument in $a3: 

li $7,3 # 0x3 
; call printf(): 

lw $2,%call16(printf) ($28) 

nop 

move $25,$2 

jalr $25 

nop 
; function epilogue: 

lw $28,40($fp) 
; set return value to 0: 

move $2,$0 

move $sp,$fp 

lw $31,52($sp) 

lw $fp,48($sp) 

addiu  $sp,$sp,56 
; return 

j $31 

nop 


Listing 1.65: Non-optimizing GCC 4.4.5 (IDA) 


.text:00000000 main: 
.text:00000000 


.text:00000000 var 28 = -0x28 

.text:00000000 var 24 = -0x24 

.text:00000000 var 20 - -0x20 

.text:00000000 var 1C = -0x1C 

.text:00000000 var 18 = -0x18 

.text:00000000 var 10 - -0x10 

.text:00000000 var 8 - -8 

.text:00000000 var 4 = -4 

. text: 00000000 

; function prologue: 

. text: 00000000 addiu  $sp, -0x38 

. text: 00000004 SW $ra, Ox38+var_4($sp) 
. text: 00000008 Sw $fp, 0x38-var 8($sp) 
.text:0000000C move $fp, $sp 
.text:00000010 la $gp, | gnu local gp 
.text:00000018 SW $gp, 0x38+var_10($5p) 
.text:0000001C la $v0, aADBDCDDDEDFDGD # "a=%d; b=%d; 


c=%d; d=%d; e=%d; f=%d; g=%"... 
; pass 5th argument in stack: 
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.text:00000024 
.text:00000028 


; pass 6th argument in stack: 


.text:0000002C 
.text:00000030 


; pass 7th argument in stack: 


.text:00000034 
.text:00000038 


; pass 8th argument in stack: 


.text:0000003C 
.text:00000040 


; pass 9th argument in stack: 


.text:00000044 
.text:00000048 
; pass 1st argument in $a0: 
.text:0000004C 
; pass 2nd argument in $al: 
.text:00000050 
; pass 3rd argument in $a2: 
.text:00000054 
; pass 4th argument in $a3: 
.text:00000058 

; call printf(): 
.text:0000005C 
.text:00000060 
.text:00000064 
.text:00000068 
.text:0000006C 

; function epilogue: 
.text:00000070 

; set return value to 0: 
.text:00000074 
.text:00000078 
.text:0000007C 
.text:00000080 
.text:00000084 

; return 

.text:00000088 
.text:0000008C 


li 
sw 


li 
sw 


li 
sw 


li 
SW 


li 
SW 


move 
li 
li 
li 


lw 
or 
move 
jalr 
or 


lw 


move 
move 
lw 

lw 
addiu 


jr 
or 


$v1, 
$v1, 


$v1, 
$v1, 


$v1, 
$v1, 


$v1, 
$v1, 


$v1, 
$v1, 


$a0, 
$al, 
$a2, 
$a3, 


$v0, 
$at, 
$t9, 
$t9 

$at, 


$9p, 


$v0, 
$sp, 
$ra, 
$fp, 
$sp, 


$ra 
$at, 


4 
0x38+var_28($5p) 


5 
0x38+var_24($5p) 


6 
0x38+var_20($5p) 


7 
0x38+var_1C($sp) 


8 
0x38+var_18($5p) 


$v0 

1 

2 

3 

(printf € OxFFFF) ($gp) 
$zero 

$v0 

$zero ; NOP 
0x38+var_10($fp) 
$zero 

$fp 
0x38+var_4($sp) 


0x38+var_8($sp) 
0x38 


$zero ; NOP 


1.11.4 Conclusion 


Here is a rough skeleton of the function call: 


Listing 1.66: x86 


PUSH 3rd argument 
PUSH 2nd argument 
PUSH 1st argument 
CALL function 


; modify stack pointer (if needed) 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


86 


Listing 1.67: x64 (MSVC) 


MOV RCX, 1st argument 
MOV RDX, 2nd argument 
MOV R8, 3rd argument 
MOV R9, 4th argument 


PUSH 5th, 6th argument, etc. (if needed) 
CALL function 
; modify stack pointer (if needed) 


Listing 1.68: x64 (GCC) 


MOV RDI, 1st argument 
MOV RSI, 2nd argument 
MOV RDX, 3rd argument 
MOV RCX, 4th argument 
MOV R8, 5th argument 
MOV R9, 6th argument 


PUSH 7th, 8th argument, etc. (if needed) 
CALL function 
; modify stack pointer (if needed) 


Listing 1.69: ARM 


MOV RO, 1st argument 

MOV R1, 2nd argument 

MOV R2, 3rd argument 

MOV R3, 4th argument 

; pass 5th, 6th argument, etc., in stack (if needed) 
BL function 

; modify stack pointer (if needed) 


Listing 1.70: ARM64 


MOV X0, 1st argument 

MOV X1, 2nd argument 

MOV X2, 3rd argument 

MOV X3, 4th argument 

MOV X4, 5th argument 

MOV X5, 6th argument 

MOV X6, 7th argument 

MOV X7, 8th argument 

; pass 9th, 10th argument, etc., in stack (if needed) 
BL function 

; modify stack pointer (if needed) 


Listing 1.71: MIPS (O32 calling convention) 


LI $4, 1st argument ; AKA $A0 
LI $5, 2nd argument ; AKA $A1 
LI $6, 3rd argument ; AKA $A2 
LI $7, 4th argument ; AKA $A3 
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; pass 5th, 6th argument, etc., in stack (if needed) 
LW temp reg, address of function 
JALR temp reg 


1.11.5 By the way 


By the way, this difference between the arguments passing in x86, x64, fastcall, 
ARM and MIPS is a good illustration of the fact that the CPU is oblivious to how the 
arguments are passed to functions. It is also possible to create a compiler that is 
able to pass arguments via a special structure without using stack at all. 


MIPS $A0 ...$A3 registers are labeled this way only for convenience (that is in the O32 
calling convention). Programmers may use any other register (well, maybe except 
$ZERO) to pass data or use any other calling convention. 


The CPU is not aware of calling conventions whatsoever. 


We may also recall how new coming assembly language programmers passing argu- 
ments into other functions: usually via registers, without any explicit order, or even 
via global variables. Of course, it works fine. 


1.12 scanf() 


Now let's use scanf(). 


1.12.1 Simple example 


#include <stdio.h> 

int main() 

{ 
int x; 
printf ("Enter X:\n"); 
scanf ("%d", &x); 


printf ("You entered %d...\n", x); 


return 0; 


ur 


It's not clever to use scanf() for user interactions nowadays. But we can, however, 
illustrate passing a pointer to a variable of type int. 


About pointers 


Pointers are one of the fundamental concepts in computer science. Often, passing a 
large array, structure or object as an argument to another function is too expensive, 
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while passing their address is much cheaper. For example, if you going to print a 
text string to console, it's much easier to pass its address into OS kernel. 


In addition if the callee function needs to modify something in the large array or 
structure received as a parameter and return back the entire structure then the 
situation is close to absurd. So the simplest thing to do is to pass the address of the 
array or structure to the callee function, and let it change what needs to be changed. 


A pointer in C/C++ is simply an address of some memory location. 


In x86, the address is represented as a 32-bit number (i.e., it occupies 4 bytes), while 
in X86-64 it is a 64-bit number (occupying 8 bytes). By the way, that is the reason 
behind some people's indignation related to switching to x86-64—all pointers in the 
x64-architecture require twice as much space, including cache memory, which is 
"expensive" memory. 


It is possible to work with untyped pointers only, given some effort; e.g. the standard 
Cfunction memcpy ( ), that copies a block from one memory location to another, takes 
2 pointers of type void* as arguments, since it is impossible to predict the type of 
the data you would like to copy. Data types are not important, only the block size 
matters. 


Pointers are also widely used when a function needs to return more than one value 
(we are going to get back to this later (3.23 on page 756) ). 


scanf() function—is such a case. 


Besides the fact that the function needs to indicate how many values were success- 
fully read, it also needs to return all these values. 


In C/C++ the pointer type is only needed for compile-time type checking. 


Internally, in the compiled code there is no information about pointer types at all. 


x86 
MSVC 


Here is what we get after compiling with MSVC 2010: 


CONST SEGMENT 


$5G3831 DB 'Enter X:', 0aH, OOH 

$SG3832 DB '%d', OOH 

$5G3833 DB 'You entered %d...', OaH, 00H 
CONST ENDS 

PUBLIC main 

EXTRN _scanf:PROC 

EXTRN _printf:PROC 


; Function compile flags: /Odtp 
_ TEXT SEGMENT 


_x$ = -4 ; size = 4 
_Main PROC 

push ebp 

mov ebp, esp 

push ecx 
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push OFFSET $SG3831 ; ‘Enter X:' 
call printf 

add esp, 4 

lea eax, DWORD PTR  x$[ebp] 


push eax 

push OFFSET $5G3832 ; '%d' 
call scanf 

add esp, 8 

mov ecx, DWORD PTR _x$[ebp] 
push ecx 


push OFFSET $SG3833 ; ‘You entered %d...' 
call printf 


add esp, 8 
; return 0 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 

main ENDP 

. TEXT ENDS 


x is a local variable. 


According to the C/C++ standard it must be visible only in this function and not from 
any other external scope. Traditionally, local variables are stored on the stack. There 
are probably other ways to allocate them, but in x86 that is the way it is. 


The goal of the instruction following the function prologue, PUSH ECX, is not to save 
the ECX state (notice the absence of corresponding POP ECX at the function's end). 


In fact it allocates 4 bytes on the stack for storing the x variable. 


X is to be accessed with the assistance of the x$ macro (it equals to -4) and the EBP 
register pointing to the current frame. 


Over the span of the function's execution, EBP is pointing to the current stack frame 
making it possible to access local variables and function arguments via EBP+of fset. 


It is also possible to use ESP for the same purpose, although that is not very conve- 
nient since it changes frequently. The value of EBP could be perceived as a frozen 
state of the value in ESP at the start of the function's execution. 


Here is a typical stack frame layout in 32-bit environment: 


EBP-8 local variable 2, marked in IDA as var 8 
EBP-4 local variable #1, marked in IDA as var 4 
EBP saved value of EBP 

EBP+4 return address 

EBP+8 argument#1, marked in IDA as arg 0 


EBP+0xC | argument#2, marked in IDA as arg 4 
EBP+0x10 | argument#3, marked in IDA as arg 8 
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The scanf() function in our example has two arguments. 


The first one is a pointer to the string containing %d and the second is the address 
of the x variable. 


First, the x variable's address is loaded into the EAX register by the 
lea eax, DWORD PTR x$[ebp] instruction. 


LEA stands for load effective address, and is often used for forming an address (.1.6 
on page 1299). 


We could say that in this case LEA simply stores the sum of the EBP register value 
and the x$ macro in the EAX register. 


This is the same as lea eax, [ebp-4]. 


So, 4 is being subtracted from the EBP register value and the result is loaded in the 
EAX register. Next the EAX register value is pushed into the stack and scanf() is 
being called. 


printf() is being called after that with its first argument — a pointer to the string: 
You entered %d...\n. 


The second argument is prepared with: mov ecx, [ebp-4]. The instruction stores 
the x variable value and not its address, in the ECX register. 


Next the value in the ECX is stored on the stack and the last printf() is being called. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


91 


MSVC + OllyDbg 


Let's try this example in OllyDbg. Let's load it and keep pressing F8 (step over) until 
we reach our executable file instead of ntdll.dll. Scroll up until main() appears. 


Click on the first instruction (PUSH EBP), press F2 (set a breakpoint), then F9 (Run). 
The breakpoint will be triggered when main() begins. 


Let's trace to the point where the address of the variable x is calculated: 


II "H(I" 
E445617 


PTR to ASCII "H(I" 


1.88E9 

1.00E91015 
O(FFFFFFFE) 
Bt FFFFFFFF) 
BL FFFFFFFF) 
OLFFFFFFFF) 


1. 00893000, ASCII "Enter MiB” Ad ceat a 


T 00E93010 
PTR DS:[<&MSUCR100.printf>] 


FDB 
EAX=0031FDB4, PTR to ASCII "H(I" 


2E ØA aa aa FF F 
FE FF FF FF|01 
61 Ø 


Figure 1.13: OllyDbg: The address of the local variable is calculated 


Right-click the EAX in the registers window and then select “Follow in stack”. 


This address will appear in the stack window. The red arrow has been added, point- 
ing to the variable in the local stack. At that moment this location contains some 
garbage (0x6E494714). Now with the help of PUSH instruction the address of this 
stack element is going to be stored to the same stack on the next position. Let's 
trace with F8 until the scanf() execution completes. During the scanf () execution, 
we input, for example, 123, in the console window: 


Enter X: 
123 
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scanf() completed its execution already: 


PUSH EBP 

MOU EBP,ESP 

PUSH ECX 

68 OAZE | PUSH OFFSET 00E93000 

FF15 9C20E9Q! CALL DoD PTR DS: [<8MSUCR106.printf>] 
8304 84 ADD ESP,4 

LER EAX, LOCAL. 1] 

PUSH EAX 

PUSH OFFSET GaE9Saac 

CALL DWORD PTR DS: (<&MSUCR1GG. scanf >] 


ADD ESP,8 

MOV ECX, DWORD PTR SS: CLOCAL. 1] 
PUSH ECX 

PUSH OFFSET SOE 2018 


.6E445RRà8 
— badioinfo 


= 06 
LESER 


NDZO m mmmmmmmm| 
Tr 


A FFFFFFFF) 
7EFDDOBOLFFF) 


TSUCRTGD. Yr TEST) ERX > 32 OCFFFFFFFF) 
ESP=6631FDAC, PTR to ASCII "Xd" 


Figure 1.14: OllyDbg: scanf () executed 


scanf () returns 1 in EAX, which implies that it has read successfully one value. If we 
look again at the stack element corresponding to the local variable it now contains 
0x7B (123). 
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Later this value is copied from the stack to the ECX register and passed to printf(): 


[a nain thread, module ex1 | [E xl 
5 PUSH EBP A 
MOU EBP,ESP 
PUSH ECX 
PUSH OFFSET GaE9saaa 
CALL DWORD PTR DS: [<8MSUCR100.printf>] 
ADD ESP,4 
LER EAX, CLOCAL. 1] 
PUSH EAX 
PUSH OFFSET aGaE9saac 
CALL DWORD PTR DS: L«&MSUCR1868.scanf?1 
ADD ESP,8 
MOY ECX, DWORD PTR SS: CLOCAL. 1] 
PUSH ECX 


PUSH OFFSET 66693616 
CALL DWORD PTR DS: [<2MSUCR100.printf>] 
ADD A: 


ØLFFFFFFFF) 
B(FFFFFFFF) 
BLFFFFFFFF) 
BtFFFFFFFF) 
7EFDDaBatFFF) 


NDO m mmmmmmmmiz 


Li = AS 


Stack [OG3IFDBO1-OO31FÜEd S ‘ T 
ECX=0000007B (decimal 123.) É ; > O(FFFFFFFF) 


0165 74 
O| FF FF FF 
61 a8 


Figure 1.15: OllyDbg: preparing the value for passing to printf () 


GCC 


Let's try to compile this code in GCC 4.4.1 under Linux: 


main proc near 


var 20 dword ptr -20h 


var 1C - dword ptr -1Ch 

var 4 - dword ptr -4 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 20h 
mov [esp+20h+var 20], offset aEnterX ; "Enter X:" 
call | puts 
mov eax, offset aD ; "%d" 
lea edx, [esp+20h+var_ 4] 
mov [esp+20h+var_1C], edx 
mov [esp+20h+var 20], eax 
call __ isoc99 scanf 
mov edx, [esp+20h+var_4] 
mov eax, offset aYouEnteredD___ ; "You entered %d...\n" 
mov [esp+20h+var_1C], edx 
mov [esp+20h+var_20], eax 
call _ printf 
mov eax, 0 
leave 
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retn 


main endp 


GCC has replaced the printf() call with call to puts(). The reason for this was 
explained in (1.5.3 on page 28). 


As in the MSVC example—the arguments are placed on the stack using the MOV in- 
struction. 


By the way 


This simple example is a demonstration of the fact that the compiler translates a list 
of expressions in C/C++-block into a sequential list of instructions. There is nothing 
in between expressions in C/C++, and so in the resulting machine code, there are 
nothing between, the control flow slips from one expression to the next one. 


x64 


The picture here is similar with the difference that the registers, rather than the 
stack, are used for arguments passing. 


MSVC 
Listing 1.72: MSVC 2012 x64 
DATA SEGMENT 
$SG1289 DB ‘Enter X:', OaH, 00H 
$SG1291 DB '%d', OOH 
$SG1292 DB 'You entered %d...', OaH, 00H 
_DATA ENDS 
_ TEXT SEGMENT 
x$ = 32 
main PROC 
$LN3: 
sub rsp, 56 
lea rcx, OFFSET FLAT:$SG1289 ; ‘Enter X:' 
call printf 
lea rdx, QWORD PTR x$[rsp] 
lea rcx, OFFSET FLAT:$SG1291 ; '%d' 
call scanf 
mov edx, DWORD PTR x$[rsp] 
lea rcx, OFFSET FLAT:$SG1292 ; ‘You entered %d...' 
call printf 
; return 0 
xor eax, eax 
add rsp, 56 
ret 0 
main ENDP 
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_ TEXT ENDS 
GCC 
Listing 1.73: Optimizing GCC 4.4.6 x64 
.LC0: 
.string "Enter X:" 
.LC1: 
.string "sd" 
.LC2: 
.string "You entered %d...\n" 
main: 
sub rsp, 24 
mov edi, OFFSET FLAT:.LCO ; "Enter X:" 
call puts 
lea rsi, [rsp+12] 
mov edi, OFFSET FLAT:.LCl ; "sd" 
xor eax, eax 
call . isoc99 scanf 
mov esi, DWORD PTR [rsp+12] 
mov edi, OFFSET FLAT:.LC2 ; "You entered %d...\n" 
xor eax, eax 
call printf 
; return 0 
xor eax, eax 
add rsp, 24 
ret 
ARM 


Optimizing Keil 6/2013 (Thumb mode) 


.text:00000042 scanf main 

.text:00000042 

.text:00000042 var 8 - -8 

.text:00000042 

.text:00000042 08 B5 PUSH {R3,LR} 

. text: 00000044 A9 AO ADR RO, aEnterX ; "Enter X:\n" 

. text: 00000046 06 FO D3 F8 BL _ 2printf 

. text: 0000004A 69 46 MOV R1, SP 

. text: 0000004C AA AO ADR RO, aD ; "%d" 

.text:0000004E 06 FO CD F8 BL . Oscanf 

.text:00000052 00 99 LDR R1, [SP,#8+var_ 8] 

.text:00000054 A9 AO ADR RO, aYouEnteredD___ ; "You entered 
95d. .. Nn" 

.text:00000056 06 FO CB F8 BL _ 2printf 

.text:0000005A 00 20 MOVS RO, 40 
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.text:0000005C 08 BD POP {R3,PC} 


In order for scanf () to be able to read item it needs a parameter— pointer to an int. 
int is 32-bit, so we need 4 bytes to store it somewhere in memory, and it fits exactly 
in a 32-bit register. A place for the local variable x is allocated in the stack and IDA 
has named it var 8. It is not necessary, however, to allocate a such since SP (stack 
pointer) is already pointing to that space and it can be used directly. 


So, SP's value is copied to the R1 register and, together with the format-string, 
passed to scanf(). 


PUSH/POP instructions behaves differently in ARM than in x86 (it's the other way 
around). They are synonyms to STM/STMDB/LDM/LDMIA instructions. And PUSH in- 
struction first writes a value into the stack, and then subtracts SP by 4. POP first 
adds 4 to SP, and then reads a value from the stack. Hence, after PUSH, SP points to 
an unused space in stack. It is used by scanf(), and by printf() after. 


LDMIA means Load Multiple Registers Increment address After each transfer. STMDB 
means Store Multiple Registers Decrement address Before each transfer. 


Later, with the help of the LDR instruction, this value is moved from the stack to the 
R1 register in order to be passed to printf(). 


ARM64 
Listing 1.74: Non-optimizing GCC 4.9.1 ARM64 
.LC0: 
.string "Enter X:" 
.LC1: 
.string "sd" 
.LC2: 
.string "You entered %d...\n" 
scanf main: 
; subtract 32 from SP, then save FP and LR in stack frame: 
stp x29, x30, [sp, -32]! 
; set stack frame (FP=SP) 
add x29, sp, 0 


; load pointer to the "Enter X:" string: 
adrp x0, .LCO 


add x0, x0, :1012:.LC0 
; XO-pointer to the "Enter X:" string 
; print it: 

bl puts 


; load pointer to the "%d" string: 
adrp x0, .LC1 


add x0, x0, :lo12:.LC1 
; find a space in stack frame for "x" variable (X1=FP+28) : 
add x1, x29, 28 


; Xl=address of "x" variable 
; pass the address to scanf() and call it: 
bl . isoc99 scanf 
load 32-bit value from the variable in stack frame: 
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ldr wl, [x29,28] 
; Wlzx 
; load pointer to the "You entered %d...\n" string 
printf() will take text string from X0 and "x" variable from X1 (or W1) 
adrp x0, .LC2 


add x0, x0, :lo12:.LC2 
bl printf 
; return 0 
mov w0, 0 
; restore FP and LR, then add 32 to SP: 
ldp x29, x30, [sp], 32 
ret 


There is 32 bytes are allocated for stack frame, which is bigger than it needed. Per- 
haps some memory aligning issue? The most interesting part is finding space for 
the x variable in the stack frame (line 22). Why 28? Somehow, compiler decided 
to place this variable at the end of stack frame instead of beginning. The address 
is passed to scanf(), which just stores the user input value in the memory at that 
address. This is 32-bit value of type int. The value is fetched at line 27 and then 
passed to printf(). 


MIPS 


A place in the local stack is allocated for the x variable, and it is to be referred as 
$sp + 24. 


Its address is passed to scanf(), and the user input values is loaded using the LW 
("Load Word") instruction and then passed to printf (). 


Listing 1.75: Optimizing GCC 4.4.5 (assembly output) 


$LCO: 
.ascii "Enter X:\000" 
$LC1: 
.ascii "%d\000" 
$LC2: 
.ascii "You entered %d...10121000" 
main: 
; function prologue: 
lui $28,%hi(_ gnu local gp) 
addiu $sp,$sp,-40 
addiu | $28,$28,910( gnu local gp) 
SW $31,36($sp) 
; call puts(): 
lw $25,%call16 (puts) ($28) 
lui $4,%hi($LC0) 
jalr $25 
addiu $4,$4,%lo($LCO) ; branch delay slot 
; call scanf(): 
lw $28,16($sp) 
lui $4,%hi($LC1) 
lw $25, %call16(_ isoc99 scanf) ($28) 


; set 2nd argument of scanf(), $al=$sp+24: 
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addiu | $5,$sp,24 
jalr $25 
addiu $4,$4,%lo($LC1) ; branch delay slot 


; call printf(): 

lw $28,16($sp) 
; set 2nd argument of printf(), 
; load word at address $sp+24: 


lw $5,24($sp) 

lw $25 ,%call16 (printf) ($28) 
lui $4, %hi($LC2) 

jalr $25 


addiu $4,$4,%lo($LC2) ; branch delay slot 


; function epilogue: 


lw $31,36($sp) 
; set return value to 0: 
move $2,$0 
; return: 
j $31 
addiu — $sp,$sp,40 ; branch delay slot 


IDA displays the stack layout as follows: 


Listing 1.76: Optimizing GCC 4.4.5 (IDA) 


.text:00000000 main: 
.text:00000000 


.text:00000000 var 18 = -0x18 

.text:00000000 var 10 = -0x10 

.text:00000000 var 4 = -4 

. text : 00000000 

; function prologue: 

. text: 00000000 lui $gp, ( gnu local gp >> 16) 

.text:00000004 addiu $sp, -0x28 

. text: 00000008 la $gp, ( gnu local gp € OxFFFF) 

.text:0000000C SW $ra, 0x28+var_4($sp) 

.text:00000010 sw $gp, 0x28+var_18($5p) 

; call puts(): 

.text:00000014 lw $t9, (puts & OxFFFF) ($gp) 

. text: 00000018 lui $a0, ($LCO >> 16) # "Enter X:" 

.text:0000001C jalr $t9 

.text:00000020 la $a0, ($LCO & OXFFFF) # "Enter X:" ; branch 
delay slot 

; call scanf(): 

.text:00000024 lw $gp, 0x28+var_18($sp) 

.text:00000028 lui $a0, ($LC1 >> 16) # "sd" 

.text:0000002C lw $t9, ( isoc99 scanf € OxFFFF)($gp) 

; set 2nd argument of scanf(), $al=$sp+24: 

. text: 00000030 addiu $al, $sp, 0x28+var_10 

.text:00000034 jalr $t9 ; branch delay slot 

. text : 00000038 la $a0, ($LC1 € OxFFFF) # "%d" 

; call printf(): 

. text :0000003C lw $gp, 0x28+var_18($sp) 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


99 


; set 2nd argument of printf(), 
; load word at address $sp+24: 


.text:00000040 lw $al, 0x28+var_10($5p) 

.text:00000044 lw $t9, (printf € OxFFFF) ($gp) 

.text:00000048 lui $a0, ($LC2 >> 16) # "You entered %d...\n" 
.text:0000004C jalr $t9 

.text:00000050 la $a0, ($LC2 € OXFFFF) # "You entered %d...\n" 


; branch delay slot 
; function epilogue: 


.text:00000054 lw $ra, 0x28+var_4($5p) 

; set return value to 0: 

.text:00000058 move $v0, $zero 

; return: 

. text: 0000005C jr $ra 

.text:00000060 addiu  $sp, 0x28 ; branch delay slot 


1.12.2 The classic mistake 


It's a very popular mistake (and/or typo) to pass a value of x instead of pointer to x: 


#include <stdio.h> 

int main() 

{ 
int x; 
printf ("Enter X:\n"); 
scanf ("%d", x); // BUG 


printf ("You entered %d...\n", x); 


return 0; 


ur 


So what happens here? x is not initialized and contains some random noise from 
local stack. When scanf() called, it takes string from user, parses it into number 
and tries to write it into x, treating it as an address in memory. But there is a random 
noise, so scanf() will try to write at random address. Most likely, the process will 
crash. 


Interestingly enough, some CRT libraries in debug build, put visually distinctive pat- 
terns into memory just allocated, like OxCCCCCCCC or OxOBADFOOD and so on. In 
this case, x may contain OxCCCCCCCC, and scanf() would try to write at address 
OxCCCCCCCC. And if you'll notice that something in your process tries to write at 
address OxCCCCCCCC, you'll know that uninitialized variable (or pointer) gets used 
without prior initialization. This is better than as if newly allocated memory is just 
cleared by zero bytes. 
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1.12.3 Global variables 


What if the x variable from the previous example isn't local but a global one? Then it 
would have been accessible from any point, not only from the function body. Global 
variables are considered anti-pattern, but for the sake of the experiment, we could 
do this. 


#include <stdio.h> 


// now x is global variable 


int x; 
int main() 
{ 
printf ("Enter X:\n"); 
scanf ("%d", &x); 
printf ("You entered %d...\n", x); 
return 0; 
i 
MSVC: x86 
_DATA SEGMENT 
COMM _x:DWORD 
$SG2456 DB ‘Enter X:', OaH, 00H 
$SG2457 DB 'sd', OOH 
$SG2458 DB 'You entered %d...', OaH, 00H 
_DATA ENDS 
PUBLIC _main 
EXTRN  scanf:PROC 
EXTRN _printf:PROC 


; Function compile flags: /Odtp 
_ TEXT SEGMENT 


_Main PROC 
push ebp 
mov ebp, esp 


push OFFSET $562456 
call printf 

add esp, 4 

push OFFSET x 

push OFFSET $562457 


call scanf 

add esp, 8 

mov eax, DWORD PTR _x 
push eax 


push OFFSET $5G2458 
call printf 


add esp, 8 
xor eax, eax 
pop ebp 
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ret 0 
main ENDP 
_ TEXT ENDS 


In this case the x variable is defined in the DATA segment and no memory is allo- 
cated in the local stack. It is accessed directly, not through the stack. Uninitialized 
global variables take no space in the executable file (indeed, why one needs to al- 
locate space for variables initially set to zero?), but when someone accesses their 
address, the OS will allocate a block of zeros there??. 


Now let's explicitly assign a value to the variable: 


int x-10; // default value 


We got: 
DATA | SEGMENT 
(X DD OaH 


Here we see a value 0xA of DWORD type (DD stands for DWORD = 32 bit) for this 
variable. 


If you open the compiled .exe in IDA, you can see the x variable placed at the begin- 
ning of the DATA segment, and after it you can see text strings. 


If you open the compiled .exe from the previous example in IDA, where the value of 
X hasn't been set, you would see something like this: 


Listing 1.77: IDA 


.data:0040FA80 x dd ? ; DATA XREF:  main+10 
.data:0040FA80 ; main-22 

.data:0040FA84 dword 40FA84 dd ? ; DATA XREF: memset-«1E 
.data:0040FA84 ; unknown libname 1-428 
.data:0040FA88 dword 40FA88 dd ? ; DATA XREF: sbh find block+5 
.data: 0040FA88 : sbh free block+2BC 
.data:0040FA8C ; LPVOID LpMem 

.data:0040FA8C lpMem dd ? ; DATA XREF: sbh find block+B 
.data:0040FA8C sbh free block+2CA 
.data:0040FA90 dword 40FA90 dd ? DATA XREF: V6 HeapAlloc+13 
.data:0040FA90 calloc impl+72 
.data:0040FA94 dword 40FA94 dd ? DATA XREF: sbh free block+2FE 


_X is marked with ? with the rest of the variables that do not need to be initialized. 
This implies that after loading the .exe to the memory, a space for all these vari- 
ables is to be allocated and filled with zeros [ISO/IEC 9899:TC3 (C C99 standard), 
(2007)6.7.8p10]. But in the .exe file these uninitialized variables do not occupy any- 
thing. This is convenient for large arrays, for example. 


72That is how a VM behaves 
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MSVC: x86 + OllyDbg 


Things are even simpler here: 


main thread, module ex2 


Registers (FPU) 


60860061 
CX 6E445AA0 MSUCR1OG. 6E445AAG 
* 6E494506 MSUCR100.  badioinfo 


C PTR to ASCII "zd" 


acsia21 

Bt FFFFFFFF) 

Bt FFFFFFFF) 

Bt FFFFFFFF) 

f - | ; | Sebit PEFDDBBOLEEF 
- — - - S Ø S E ) 7 ¡BBB Í ) 

MSUCR100. scanf returned EN! TAO GS 0028 , OCFFFFFFFF) 


@ LastErr 
EFL aaaaca2a6 


Mi from eu2.! 


TEFDEGBGG 


Figure 1.16: OllyDbg: after scanf() execution 


The variable is located in the data segment. After the PUSH instruction (pushing the 
address of x) gets executed, the address appears in the stack window. Right-click 
on that row and select "Follow in dump". The variable will appear in the memory 
window on the left. After we have entered 123 in the console, 0x7B appears in the 
memory window (see the highlighted screenshot regions). 


But why is the first byte 7B? Thinking logically, 00 00 00 7B must be there. The 
cause for this is referred as endianness, and x86 uses little-endian. This implies that 
the lowest byte is written first, and the highest written last. Read more about it at: 
2.2 on page 572. Back to the example, the 32-bit value is loaded from this memory 
address into EAX and passed to printf(). 


The memory address of x is 0x00C53394. 
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In OllyDbg we can review the process memory map (Alt-M) and we can see that this 
address is inside the . data PE-segment of our program: 


Address [Si i Contains iti aj 
66078800) 66067000 C:\WindowssSystem32% locale.nl¢ 
96198660) aaaaceao Heap 
96269000) aaaa? ana 
B044C000| aaaataoao 
664406806) 00003000 Stack of main thread 
88590000) aaaa?aaoo 
96750000) aaaacaaa Default heap 
aacsaaana| aaaataaao PE header 
aacciaaoa| 00001000 .teut 
B0CS2000| 00001000 .rdata 
B0C53000' 00001000 «data 
B0C54000| 00001000 «reloc Re locat ions 

£E3E0000| 66001606) MSUCR100 PE header 

6E3E1000| aaap2aaa| MSUCR100 etext Code, imports, exports 
£E493000| 66066006) MSUCRIGO «data Data 

6E499000| 00001000 | MSUCR100 rere Resources 

£E49A000| aaaasaaa| MSUCRIGO .reloc |Relocations 

7550090090 | 09091900 | Mod_755D PE header 

75501000 | 00003000 
755049009 | 00001000 
75505000 | aaaasana 
755E0000| 09091900 | Mod_755E PE header 
755E1000| 00040000 
7562E000| aaaacana 
75633000 | 00009900A 
75640000 | 00091900 | Mod_7564 PE header 
75641000| 00033000 
75679000 | 00002200A 
7567B000| 00004000 
76F50000| 09010900 | kerne 132 PE header 

76F60000| 099000990! kerne 132 Code, imports,exports 
77030000 | 00010900 | kerne 132 Data 

77040000| 000100090 | kerne 132 Resources 

7/050000| 0009B9090 | kerne 132 Relocations 

77210000 | 00001000 | KERNELBASE PE header 

77811660) 00040000 | KERNELBASE Code, imports, exports 
77851600) 6962000) KERNELBASE Data 

77853606) 66061606) KERNELBASE Resources 

77254000 | 00003000 | KERNELBASE Re locations 

77B20000| 66061606) Mod ?7B2 PE header 

77821000 | 00102000 
77C23000| Bab2Fa08 
77052000 | aaaacaaa 
77C5E000| DODEBGOO 
77000909 | 00001000 PE header 
77016666) aaaD6oaoa Code, exports 
770F0000| 600901900 RT Code 
77E00000| 0003000) ntd | Data 


= 
m 


= 
m 


= 
m 


m 


<= 
m 


= 
m 


[xdg a a a prc alates” otal! 


Figure 1.17: OllyDbg: process memory map 


GCC: x86 


The picture in Linux is near the same, with the difference that the uninitialized vari 
ables are located in the bss segment. In ELF’? file this segment has the following 
attributes: 


Segment type: Uninitialized 
Segment permissions: Read/Write 


, 
, 


If you, however, initialize the variable with some value e.g. 10, it is to be placed in 
the data segment, which has the following attributes: 


Segment type: Pure data 
Segment permissions: Read/Write 


, 
, 


MSVC: x64 


73 Executable and Linkable Format: Executable File format widely used in *NIX systems including Linux 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


104 


Listing 1.78: MSVC 2012 x64 


DATA | SEGMENT 
COMM x : DWORD 
$SG2924 DB ‘Enter X:', OaH, 00H 
$SG2925 DB '%d', OOH 
$SG2926 DB 'You entered %d...', OaH, 00H 
_DATA ENDS 
TEXT | SEGMENT 
main PROC 
$LN3: 
sub rsp, 40 
lea rcx, OFFSET FLAT:$SG2924 ; ‘Enter X:' 
call printf 
lea rdx, OFFSET FLAT:x 
lea rcx, OFFSET FLAT:$SG2925 ; '%d' 
call scanf 
mov edx, DWORD PTR x 
lea rcx, OFFSET FLAT:$SG2926 ; ‘You entered %d...' 
call printf 
; return 0 
xor eax, eax 
add rsp, 40 
ret 0 
main ENDP 
TEXT X ENDS 


The code is almost the same as in x86. Please note that the address of the x variable 
is passed to scanf() using a LEA instruction, while the variable's value is passed to 


the second prin 
language (no rel 


tf() using a MOV instruction. DWORD PTR—is a part of the assembly 
ation to the machine code), indicating that the variable data size is 


32-bit and the MOV instruction has to be encoded accordingly. 


ARM: Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.79: IDA 


.text:00000000 ; Segment type: Pure code 

.text:00000000 AREA .text, CODE 

.text:00000000 main 

.text:00000000 PUSH {R4, LR} 

. text: 00000002 ADR RO, aEnterX "Enter X:\n" 
.text:00000004 BL . 2printf 

.text:00000008 LDR R1, =x 

.text:0000000A ADR RO, aD ; "Sg" 
.text:0000000C BL . Oscanf 

.text:00000010 LDR RO, =x 

.text:00000012 LDR R1, [RO] 
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.text:00000014 ADR RO, aYouEnteredD . ; "You entered %d...\n" 

.text:00000016 BL . 2printf 

.text:0000001A MOVS RO, 40 

.text:0000001C POP (R4, PC} 

.text:00000020 aEnterX DCB "Enter X:",0xA,0 ; DATA XREF: main+2 

.text:0000002A DCB 0 

.text:0000002B DCB 0 

.text:0000002C off 2C DCD x ; DATA XREF: main+8 

.text:0000002C ; main+10 

.text:00000030 aD DCB "%d",0 ; DATA XREF: main+A 

. text: 00000033 DCB 0 

.text:00000034 aYouEnteredD . DCB "You entered %d...",0xA,0 ; DATA XREF: 
main+14 

. text: 00000047 DCB 0 


.text:00000047 ; .text ends 
. text: 00000047 


.data:00000048 ; Segment type: Pure data 


. data: 00000048 AREA .data, DATA 

. data: 00000048 ; ORG 0x48 

. data: 00000048 EXPORT x 

.data: 00000048 x DCD OxA ; DATA XREF: main+8 
. data: 00000048 ; main+10 


.data:00000048 ; .data ends 


So, the x variable is now global and for this reason located in another segment, 
namely the data segment (.data). One could ask, why are the text strings located 
in the code segment (.text) and x is located right here? Because it is a variable and 
by definition its value could change. Moreover it could possibly change often. While 
text strings has constant type, they will not be changed, so they are located in the 
.text segment. 


The code segment might sometimes be located in a ROM” chip (keep in mind, we 
now deal with embedded microelectronics, and memory scarcity is common here), 
and changeable variables —in RAM”, 


It is not very economical to store constant variables in RAM when you have ROM. 


Furthermore, constant variables in RAM must be initialized, because after powering 
on, the RAM, obviously, contains random information. 


Moving forward, we see a pointer to the x (off 2C) variable in the code segment, 
and that all operations with the variable occur via this pointer. 


That is because the x variable could be located somewhere far from this particular 
code fragment, so its address must be saved somewhere in close proximity to the 
code. 


The LDR instruction in Thumb mode can only address variables in a range of 1020 
bytes from its location, 


74Read-Only Memory 
75Random-Access Memory 
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and in ARM-mode —variables in range of +4095 bytes. 


And so the address of the x variable must be located somewhere in close proximity, 
because there is no guarantee that the linker would be able to accommodate the 
variable somewhere nearby the code, it may well be even in an external memory 
chip! 


One more thing: if a variable is declared as const, the Keil compiler allocates it in 
the .constdata segment. 


Perhaps thereafter, the linker could place this segment in ROM too, along with the 
code segment. 


ARM64 
Listing 1.80: Non-optimizing GCC 4.9.1 ARM64 
. comm x,4,4 
.LC0: 
.string "Enter X:" 
.LC1: 
.string "sd" 
.LC2: 
.string "You entered %d...\n" 
f5: 
; save FP and LR in stack frame: 
stp x29, x30, [sp, -16]! 
; set stack frame (FP=SP) 
add x29, sp, 0 


load pointer to the "Enter X:" string: 
adrp x0, .LCO 
add x0, x0, :1012:.LC0 
bl puts 

; load pointer to the "%d" string: 

adrp x0, .LC1 


add x0, x0, :1012:.LC1 
; form address of x global variable: 
adrp xl, x 
add X1, x1, :lo12:x 
bl . isoc99 scanf 
; form address of x global variable again: 
adrp x0, x 
add x0, x0, :lo12:x 


; load value from memory at this address: 
ldr wl, [x0] 

; load pointer to the "You entered %d...\n" string: 
adrp x0, .LC2 


add x0, x0, :lo12:.LC2 
bl printf 

; return 0 
mov w0, 0 

; restore FP and LR: 
ldp x29, x30, [sp], 16 
ret 
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In this case the z variable is declared as global and its address is calculated using 
the ADRP/ADD instruction pair (lines 21 and 25). 


MIPS 


Uninitialized global variable 


So now the z variable is global. Let's compile to executable file rather than object file 
and load it into IDA. IDA displays the x variable in the . sbss ELF section (remember 
the "Global Pointer"? 1.5.4 on page 33), since the variable is not initialized at the 
start. 


Listing 1.81: Optimizing GCC 4.4.5 (IDA) 


.text:004006C0 main: 
. text: 004006C0 


.text:004006C0 var_10 = -0x10 

.text:004006C0 var 4 = -4 

. text: 004006C0 

; function prologue: 

. text :004006C0 lui $gp, 0x42 

.text:004006C4 addiu $sp, -0x20 

.text:004006C8 li $gp, 0x418940 

.text:004006CC SW $ra, 0x20+var_4($sp) 

.text:004006D0 SW $gp, 0x20«var 10($sp) 

; call puts(): 

.text:004006D4 la $t9, puts 

.text:004006D8 lui $a0, 0x40 

.text:004006DC jalr $t9 ; puts 

.text:004006E0 la $a0, aEnterX # "Enter X:" ; branch delay 

E catis beantiys 

.text:004006E4 lw $gp, 0x20«var 10($sp) 

.text:004006E8 lui $a0, 0x40 

.text:004006EC la $t9, — isoc99 scanf 

; prepare address of x: 

.text:004006F0 la $al, x 

.text:004006F4 jalr $t9 ; isoc99 scanf 

.text:004006F8 la $a0, aD # "sd" ; branch delay slot 

; call printf(): 

.text:004006FC lw $gp, 0x20«var 10($sp) 

.text:00400700 lui $a0, 0x40 

; get address of x: 

.text:00400704 la $v0, x 

.text:00400708 la $t9, printf 

; load value from "x" variable and pass it to printf() in $al: 

.text:0040070C lw $al, (x - 0x41099C)($v0) 

.text:00400710 jalr $t9 ; printf 

. text: 00400714 la $a0, aYouEnteredD . # "You entered %d...\n" 
; branch delay slot 

; function epilogue: 

.text:00400718 lw $ra, 0x20+var_4($sp) 

.text:0040071C move $v0, $zero 
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.text:00400720 jr $ra 
.text:00400724 addiu  $sp, 0x20 ; branch delay slot 


.Sbss:0041099C # Segment type: Uninitialized 


.sbss:0041099C .sbss 
.sbss:0041099C .globl x 
.Sbss:0041099C x: .space 4 


.Sbss:0041099C 


IDA reduces the amount of information, so we'll also do a listing using objdump and 


comment it: 


Listing 1.82: Optimizing GCC 4.4.5 (objdump) 


004006c0 «main»: 

; function prologue: 
4006c0: 3c1c0042 lui gp, 0x42 
4006c4: 27bdffe0 addiu sp,sp, -32 
4006c8: 279c8940 addiu gp. gp, -30400 


4006cc: afbfO00lc sw ra,28(sp) 
4006d0: afbc0010 sw gp,16(sp) 

; call puts(): 
4006d4: 8f998034 lw t9, -32716(gp) 
4006d8: 3c040040 lui a0 ,0x40 


4006dc: 0320f809 jalr t9 
4006e0: 248408f0 addiu  a0,a0,2288 ; branch delay slot 
call scanf(): 


4006e4: 8fbc0010 lw gp, 16(sp) 

4006e8: 3c040040 lui a0,0x40 

4006ec: 8f998038 lw t9, -32712(gp) 
; prepare address of x: 

4006f0: 8f858044 lw al,-32700(gp) 


4006f4: 0320f809 jalr t9 
4006f8: 248408fc addiu a0,a0,2300 ; branch delay slot 
call printf(): 


4006fc: 8fbc0010 lw gp,16(sp) 
400700: 3c040040 lui a0,0x40 
; get address of x: 
400704: 8f828044 lw v0, -32700(gp) 
400708: 8f99803c lw t9,-32708(gp) 
; load value from "x" variable and pass it to printf() in $al: 
40070c: 8c450000 lw al,0(v0) 


400710: 0320f809 jalr t9 
400714: 24840900 addiu a0,a0,2304 ; branch delay slot 
function epilogue: 


400718: 8fbf001c lw ra,28(sp) 

40071c: 00001021 move vO,zero 

400720: 03e00008 jr ra 

400724: 27bd0020 addiu sp,sp,32 ; branch delay slot 


pack of NOPs used for aligning next function start on 16-byte boundary: 
400728: 00200825 move at,at 
40072c: 00200825 move at,at 
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Now we see the zx variable address is read from a 64KiB data buffer using GP and 
adding negative offset to it (line 18). More than that, the addresses of the three 
external functions which are used in our example (puts(), scanf(), printf()), are 
also read from the 64KiB global data buffer using GP (lines 9, 16 and 26). GP points to 
the middle of the buffer, and such offset suggests that all three function's addresses, 
and also the address of the x variable, are all stored somewhere at the beginning of 
that buffer. That make sense, because our example is tiny. 


Another thing worth mentioning is that the function ends with two NOPs (MOVE $AT,$AT 
— an idle instruction), in order to align next function's start on 16-byte boundary. 


Initialized global variable 


Let's alter our example by giving the z variable a default value: 


int x=10; // default value 


Now IDA shows that the z variable is residing in the .data section: 


Listing 1.83: Optimizing GCC 4.4.5 (IDA) 


.text:004006A0 main: 

.text:004006A0 

.text:004006A0 var 10 - -0x10 

.text:004006A0 var 8 = -8 

.text:004006A0 var 4 = -4 

. text :004006A0 

. text: 004006A0 lui $gp, 0x42 
.text:004006A4 addiu $sp, -0x20 
.text:004006A8 li $gp, 0x418930 
.text:004006AC SW $ra, 0x20+var_4($sp) 
.text:004006B0 SW $s0, 0x20+var_8($sp) 
. text :004006B4 Sw $gp, 0x20+var_10($sp) 
.text:004006B8 la $t9, puts 
.text:004006BC lui $a0, 0x40 

. text: 004006C0 jalr $t9 ; puts 

. text: 004006C4 la $a0, aEnterX # "Enter X:" 
. text: 004006C8 lw $gp, Ox20+var_10($sp) 
; prepare high part of x address: 

. text: 004006CC lui $s0, 0x41 
.text:004006D0 la $t9, — isoc99 scanf 
.text:004006D4 lui $a0, 0x40 

; add low part of x address: 

.text:004006D8 addiu $al, $s0, (x - 0x410000) 
; now address of x is in fal. 

.text:004006DC jalr $t9 ; isoc99 scanf 
.text:004006E0 la $a0, aD H "sd" 
. text :004006E4 lw $gp, 0x20+var_10($sp) 
; get a word from memory: 

.text:004006E8 lw $al, x 

; value of x is now in $al. 

.text:004006EC la $t9, printf 
.text:004006F0 lui $a0, 0x40 
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.text:004006F4 jalr $t9 ; printf 

. text: 004006F8 la $a0, aYouEnteredD # "You entered %d...\n" 
.text:004006FC lw $ra, 0x20+var_4($sp) 

.text:00400700 move $v0, $zero 

.text:00400704 lw $s0, Ox20+var_8($sp) 

. text: 00400708 jr $ra 

.text:0040070C addiu $sp, 0x20 

.data:00410920 .globl x 

.data:00410920 x: .word OXA 


Why not .sdata? Perhaps that this depends on some GCC option? 


Nevertheless, now z is in .data, which is a general memory area, and we can take a 
look how to work with variables there. 


The variable’s address must be formed using a pair of instructions. 


In our case those are LUI (“Load Upper Immediate”) and ADDIU (“Add Immediate 
Unsigned Word”). 


Here is also the objdump listing for close inspection: 


Listing 1.84: Optimizing GCC 4.4.5 (objdump) 


004006a0 <main>: 
4006a0: 3c1c0042 lui gp,0x42 
4006a4: 27bdffe0 addiu sp,sp, -32 
4006a8: 279c8930 addiu gp. gp, -30416 


4006ac: afbf001c sw ra,28(sp) 
4006b0: afb00018 sw s0,24(sp) 
4006b4: afbc0010 sw gp,16(sp) 
4006b8: 8f998034 lw t9,-32716(9p) 
4006bc: 3c040040 lui a0,0x40 


4006c0: 0320f809 jalr t9 
4006c4: 248408d0 addiu  a0,a0,2256 


4006c8: 8fbc0010 lw gp,16(sp) 

; prepare high part of x address: 
4006cc: 3c100041 lui s0,0x41 
4006d0: 8f998038 lw t9,-32712(9p) 
40064: 3c040040 lui a0,0x40 


; add low part of x address: 
4006d8: 26050920 addiu al,s0,2336 
; now address of x is in $al. 
4006dc: 0320f809 jalr t9 
4006e0: 248408dc addiu a0,a0,2268 
4006e4: 8fbc0010 lw gp,16(sp) 
high part of x address is still in $s0. 
; add low part to it and load a word from memory: 


4006e8: 8e050920 lw a1,2336(s0) 

; value of x is now in $al. 
4006ec: 8f99803c lw t9,-32708(gp) 
4006f0: 3c040040 lui a0,0x40 
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4006f4: 0320f809 jalr t9 
4006f8: 248408e0 addiu  a0,a0,2272 


4006fc: 8fbf001c lw ra,28(sp) 
400700: 00001021 move v0,zero 
400704: 8fb00018 lw s0,24(sp) 
400708: 03e00008 jr ra 


40070c: 27bd0020 addiu sp,sp,32 


We see that the address is formed using LUI and ADDIU, but the high part of address 
is still in the $SO register, and it is possible to encode the offset in a LW ("Load Word") 
instruction, so one single LW is enough to load a value from the variable and pass it 
to printf(). 


Registers holding temporary data are prefixed with T-, but here we also see some pre- 
fixed with S-, the contents of which must be preserved before use in other functions 
(i.e., saved somewhere). 


That is why the value of $50 has been set at address 0x4006cc and has been used 
again at address 0x4006e8, after the scanf() call. The scanf() function does not 
change its value. 


1.12.4 scanf() 


As was noted before, it is slightly old-fashioned to use scanf() today. But if we have 
to, we have to check if scanf() finishes correctly without an error. 


#include <stdio.h> 


int main() 
{ 
int x; 
printf ("Enter X:\n"); 


if (scanf ("%d", &x)==1) 

printf ("You entered %d...\n", x); 
else 

printf ("What you entered? Huh?\n"); 


return 0; 


F 


By standard, the scanf () "? function returns the number of fields it has successfully 
read. 


In our case, if everything goes fine and the user enters a number scanf() returns 1, 
or in case of error (or EOF77) — 0. 


Let's add some C code to check the scanf() return value and print error message 
in case of an error. 


This works as expected: 


76scanf, wscanf: MSDN 
77End of File 
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C:\...>ex3.exe 
Enter X: 

123 

You entered 123... 


C:\...>ex3.exe 

Enter X: 

ouch 

What you entered? Huh? 


MSVC: x86 
Here is what we get in the assembly output (MSVC 2010): 
lea eax, DWORD PTR _x$[ebp] 
push eax 
push OFFSET $56G3833 ; '%d', 00H 
call  Scanf 
add esp, 8 
cmp eax, 1 
jne SHORT $LN2@main 
mov ecx, DWORD PTR _x$[ebp] 
push ecx 
push OFFSET $5G3834 ; 'You entered %d...', OaH, 00H 
call _printf 
add esp, 8 
jmp SHORT $LN1@main 
$LN2@main: 
push OFFSET $SG3836 ; ‘What you entered? Huh?', OaH, 00H 
call _ printf 
add esp, 4 
$LN1@main: 
xor eax, eax 


The caller function (main()) needs the callee function (scanf ()) result, so the callee 
returns it in the EAX register. 


We check it with the help of the instruction CMP EAX, 1 (CoMPare). In other words, 
we compare the value in the EAX register with 1. 


A JNE conditional jump follows the CMP instruction. JNE stands for Jump if Not Equal. 


So, if the value in the EAX register is not equal to 1, the CPU will pass the execution 
to the address mentioned in the JNE operand, in our case $LN2@main. Passing the 
control to this address results in the CPU executing printf() with the argument 
What you entered? Huh?. But if everything is fine, the conditional jump is not be 
taken, and another printf() call is to be executed, with two arguments: 

'You entered %d...' and the value of x. 


Since in this case the second printf() has not to be executed, there is a JMP pre- 
ceding it (unconditional jump). It passes the control to the point after the second 
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printf() and just before the XOR EAX, EAX instruction, which implements return 
9. 


So, it could be said that comparing a value with another is usually implemented by 
CMP/Jcc instruction pair, where cc is condition code. CMP compares two values and 
sets processor flags’®. Jcc checks those flags and decides to either pass the control 
to the specified address or not. 


This could sound paradoxical, but the CMP instruction is in fact SUB (Subtract). All 
arithmetic instructions set processor flags, not just CMP. If we compare 1 and 1, 1-1 
is O so the ZF flag would be set (meaning that the last result is O). In no other 
circumstances ZF can be set, except when the operands are equal. JNE checks only 
the ZF flag and jumps only if it is not set. JNE is in fact a synonym for JNZ (Jump if 
Not Zero). Assembler translates both JNE and JNZ instructions into the same opcode. 
So, the CMP instruction can be replaced with a SUB instruction and almost everything 
will be fine, with the difference that SUB alters the value of the first operand. CMP is 
SUB without saving the result, but affecting flags. 


MSVC: x86: IDA 


It is time to run IDA and try to do something in it. By the way, for beginners it is good 
idea to use /MD option in MSVC, which means that all these standard functions are 
not be linked with the executable file, but are to be imported from the MSVCR*.DLL 
file instead. Thus it will be easier to see which standard function are used and where. 


While analyzing code in IDA, it is very helpful to leave notes for oneself (and others). 
In instance, analyzing this example, we see that JNZ is to be triggered in case of an 
error. So it is possible to move the cursor to the label, press "n" and rename it to 
"error". Create another label—into "exit". Here is my result: 


.text:00401000 main proc near 
.text:00401000 
.text:00401000 var 4 
.text:00401000 argc 
.text:00401000 argv 
.text:00401000 envp 
.text:00401000 


dword ptr -4 
dword ptr 8 
dword ptr Ch 
dword ptr 10h 


.text:00401000 push ebp 
.text:00401001 mov ebp, esp 
.text:00401003 push ecx 
.text:00401004 push offset Format ; "Enter X:\n" 
.text:00401009 call ds:printf 
.text:0040100F add esp, 4 
.text:00401012 lea eax, [ebp-*var 4] 
.text:00401015 push eax 
.text:00401016 push offset aD ; "%d" 
.text:0040101B call ds:scanf 
.text:00401021 add esp, 8 
.text:00401024 cmp eax, 1 
.text:00401027 jnz short error 
.text:00401029 mov ecx, [ebp+var_4] 


78x86 flags, see also: wikipedia. 
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.text:0040102C push ecx 

.text:0040102D push offset aYou ; "You entered %d...\n" 
.text:00401032 call ds:printf 

.text:00401038 add esp, 8 

.text:0040103B jmp short exit 


.text:0040103D 
.text:0040103D error: ; CODE XREF: main+27 


.text:0040103D push offset aWhat ; "What you entered? Huh?\n" 
.text:00401042 call ds:printf 
.text:00401048 add esp, 4 


.text:0040104B 
.text:0040104B exit: ; CODE XREF: main+3B 


.text:0040104B xor eax, eax 
.text:0040104D mov esp, ebp 
.text:0040104F pop ebp 
.text:00401050 retn 


.text:00401050 main endp 


Now it is slightly easier to understand the code. However, it is not a good idea to 
comment on every instruction. 


You could also hide(collapse) parts of a function in IDA. To do that mark the block, 
then press Ctrl-"-" on the numerical pad and enter the text to be displayed instead. 


Let's hide two blocks and give them names: 


.text:00401000 text segment para public 'CODE' use32 
.text:00401000 assume cs: text 

.text:00401000 ;org 401000h 

.text:00401000 ; ask for X 

.text:00401012 ; get X 


.text:00401024 cmp eax, 1 
.text:00401027 jnz short error 
.text:00401029 ; print result 
.text:0040103B jmp short exit 


.text:0040103D 
.text:0040103D error: ; CODE XREF: main+27 


.text:0040103D push offset aWhat ; "What you entered? Huh?\n" 
.text:00401042 call ds:printf 
.text:00401048 add esp, 4 


.text:0040104B 
.text:0040104B exit: ; CODE XREF: main+3B 


.text:0040104B xor eax, eax 
.text:0040104D mov esp, ebp 
. text: 0040104F pop ebp 

. text: 00401050 retn 


.text:00401050 main endp 


To expand previously collapsed parts of the code, use Ctrl-“+” on the numerical pad. 
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By pressing "space", we can see how IDA represents a function as a graph: 


; int _ cdecl main() 
| nain proc near 


var h- duord ptr -4 
argc- dword ptr 8 

argu= dword ptr 6Ch 
enup- dword ptr 16h 


offset Format ; "Enter X:\n" 
call ds:printf 

add esp, ^ 

lea eax, [ebp*var 4] 

push eax 

push offset aD ; "ed" 

call ds :scanf 
add esp, 8 

cmp eax, 1 

j short error 


ecx, [ebptvar_4] 

ecx "ror: ; “What you entered? Huh?\n" 
offset aYou ; “You entered %d...\n" offset aWhat 

ds:printf ds:printf 

esp, 8 esp, ^ 

short exit 


| main endp 


Figure 1.18: Graph mode in IDA 


There are two arrows after each conditional jump: green and red. The green arrow 
points to the block which executes if the jump is triggered, and red if otherwise. 
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It is possible to fold nodes in this mode and give them names as well ("group nodes"). 
Let's do it for 3 blocks: 


; int _ cdecl main() 
| nain proc near 


var_4= dword ptr -4 
argc- dword ptr 8 

argu- dword ptr BCh 
enup- dvord ptr 18h 


offset Format ; "Enter 
call ds:printf 

add esp, ^ 

lea eax, [ebp*var 4^] 

push eax 

push offset aD ; "*d" 
call ds :scanf 
add esp, 8 

cmp eax, 1 

j short error 


N:Xn" 


BNW WE 7 


Figure 1.19: Graph mode in IDA with 3 nodes folded 


That is very useful. It could be said that a very important part of the reverse engi- 
neers' job (and any other researcher as well) is to reduce the amount of information 
they deal with. 
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MSVC: x86 + OllyDbg 


Let's try to hack our program in OllyDbg, forcing it to think scanf() always works 
without error. When an address of a local variable is passed into scanf(), the vari- 
able initially contains some random garbage, in this case 0x6E494714: 


CPU - main thread, module ex3 (Oj xl 
J . ] ^^ 


SUCR188.6E445617 


15 


Bt FFFFFFFF) 
@( FFFFFFFF) 
B(FFFFFFFF) 
Bt FFFFFFFF) 
TEFDDOBOLFFF) 
G(FFFFFFFF) 


ili 
Stack [0042FBD6]=ex3.06323000, ASCII "Enter x:0” 
EAX=0042FBD4 


IDAONDIO m  mmmmmmmim 


Address [Heu dump — |] 
45 4 65 z] 

3 ente 

What 


aaaaaaaa 


Figure 1.20: OllyDbg: passing variable address into scanf () 
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While scanf() executes, in the console we enter something that is definitely not a 
number, like “asdasd”. scanf() finishes with O in EAX, which indicates that an error 
has occurred. 


We can also check the local variable in the stack and note that it has not changed. 
Indeed, what would scanf () write there? It simply did nothing except returning zero. 


Let's try to "hack" our program. Right-click on EAX, Among the options there is "Set 
to 1". This is what we need. 


We now have 1 in EAX, so the following check is to be executed as intended, and 
printf() will print the value of the variable in the stack. 


When we run the program (F9) we can see the following in the console window: 


Listing 1.85: console window 


Enter X: 
asdasd 
You entered 1850296084... 


Indeed, 1850296084 is a decimal representation of the number in the stack (0x6E494714)! 
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MSVC: x86 + Hiew 


This can also be used as a simple example of executable file patching. We may try to 
patch the executable so the program would always print the input, no matter what 
we enter. 


Assuming that the executable is compiled against external MSVCR* . DLL (i.e., with /MD 
option) 79, we see the main() function at the beginning of the . text section. Let's 
open the executable in Hiew and find the beginning of the . text section (Enter, F8, 
F6, Enter, Enter). 


We can see this: 


C: \Polygon\ollydbg\ex3.exe a32 PE .00401000|Hie 
.00401000: ebp 
.00401001: ebp,esp 
-.00401003: ecx 
.00401004: ; Enter X:' --B 
.00401009: printf 
.0040100F: 83C404 esp, 
.00401012: 8D45FC eax, [ebp][-4] 
.00401015: 50 eax 
.00401016: 68 --B 
.0040101B: FF15 scanf 
.00401021: 83C408 esp, 
.00401024: 83F801 eax, 
.00401027: 7514 --B 
.00401029: 8BADFC ecx, [ebp][-4] 
.0040102C: 51 < 
.0040102D: 68 ; You entered Xd...' 
.00401032: FF15 
.00401038: 83C408 
.0040103B: EBOE 
.0040103D: 68 
.00401042: FF15 
.00401048: 83C404 
.0040104B: 33C0 
.0040104D: 8BE5 esp,ebp 
.0040104F: 5D ebp 
.00401050: C3 Ro-eALASALNRLALACALALALACACA AULA LA 
.00401051: B84D5A0000 

2FilBlk 3CryBlk 


Figure 1.21: Hiew: main() function 


Hiew finds ASCIIZ9? strings and displays them, as it does with the imported functions’ 
names. 


7?that's what also called "dynamic linking" 
80ASCII Zero (null-terminated ASCII string ) 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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Move the cursor to address .00401027 (where the JNZ instruction, we have to bypass, 
is located), press F3, and then type "9090" (meaning two NOPs): 


C:\Polygon\ollydbg\ex3.exe 
00000400: 
00000401: 
00000403: 
00000404: 
00000409: 
00000490F : 
00000412: 
00000415: 
00000416: 
0000041B: 
00000421 : 
00000424: 
00000427: 
00000428: 
00000429: 
0000042C: 
0000042D: 
00000432: 
00000438: 
0000043B: 
0000043D: 
00000442: 
00000448: 
0000044B: 
0000044D: 
0000044F : 
00000450: 

1] E 


55 
8BEC 
51 

68 
FF15 
83C404 
8D45FC 
50 

68 
FF15 
83C408 
83F801 
9g 

9 
8B4DFC 
51 

68 
FF15 
83C408 
EBOE 
68 
FF15 
83C404 
3300 
8BES 
5D 


BIFWO EDITMODE 


a32 PE 0004 
ebp 
ebp,esp 
ecx 

55 Q0 ' 
d, [000402094] 
esp, 
eax, [ebp][ -4] 
eax 

;' QeB' 
d, [00040208C] 
esp, 
eax, 


ecx, [ebp][-4] 


CX 


;' gon 
d, [000402094] 
esp, 


;' 005" 
d, [000402094] 
esp, 
eax,eax 
esp,ebp 
ebp 


A_A_A_A_A_A_A_A_A_A_A_A_A 


Figure 1.22: Hiew: replacing JNZ with two NOPs 


Then press F9 (update). Now the executable is saved to the disk. It will behave as 


we wanted. 


Two NOPs are probably not the most aesthetic approach. Another way to patch this 
instruction is to write just O to the second byte of opcode (jump offset), so that JNZ 
will always jump to the next instruction. 


We could also do the opposite: replace first byte with EB while not touching the sec- 
ond byte (jump offset). We would get an unconditional jump that is always triggered. 
In this case the error message would be printed every time, no matter the input. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 
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MSVC: x64 


Since we work here with int-typed variables, which are still 32-bit in x86-64, we see 
how the 32-bit part of the registers (prefixed with E-) are used here as well. While 
working with pointers, however, 64-bit register parts are used, prefixed with R-. 


Listing 1.86: MSVC 2012 x64 


DATA | SEGMENT 


$SG2924 DB ‘Enter X:', OaH, 00H 
$5G2926 DB '9d', OOH 
$SG2927 DB 'You entered %d...', OaH, 00H 
$5G2929 DB ‘What you entered? Huh?', 0aH, 00H 
DATA ENDS 
TEXT | SEGMENT 
x$ = 32 
main PROC 
$LN5: 
sub rsp, 56 
lea rcx, OFFSET FLAT:$SG2924 ; ‘Enter X:' 
call printf 
lea rdx, QWORD PTR x$[rsp] 
lea rcx, OFFSET FLAT:$SG2926 ; '%d' 
call scanf 
cmp eax, 1 
jne SHORT $LN2@main 
mov edx, DWORD PTR x$[rsp] 
lea rcx, OFFSET FLAT:$SG2927 ; ‘You entered %d...' 
call printf 
jmp SHORT $LN1@main 
$LN2@main: 
lea rcx, OFFSET FLAT:$SG2929 ; ‘What you entered? Huh?' 
call printf 
$LN1@main: 
; return 0 
xor eax, eax 
add rsp, 56 
ret 0 
main ENDP 
_TEXT ENDS 
END 
ARM 


ARM: Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.87: Optimizing Keil 6/2013 (Thumb mode) 


var_8 = -8 


PUSH (R3,LR) 
ADR RO, aEnterX ; "Enter X:\n" 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


(OD O0 -4 OY Ul UNA 
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BL _ 2printf 
MOV R1, SP 
ADR RO, aD ; "Sd" 
BL . Oscanf 
CMP RO, #1 
BEQ loc 1E 
ADR RO, aWhatYouEntered ; "What you entered? Huh?\n" 
BL _ 2printf 
loc 1A ; CODE XREF: main+26 
MOVS RO, #0 
POP {R3, PC} 
loc 1E ; CODE XREF: main+12 
LDR R1, [SP,#8+var_8] 
ADR RO, aYouEnteredD . ; "You entered %d...\n" 
BL _ 2printf 
B loc 1A 


The new instructions here are CMP and BEQ?!, 


CMP is analogous to the x86 instruction with the same name, it subtracts one of the 
arguments from the other and updates the conditional flags if needed. 


BEQ jumps to another address if the operands were equal to each other, or, if the 
result of the last computation has been 0, or if the Z flag is 1. It behaves as JZ in 
x86. 


Everything else is simple: the execution flow forks in two branches, then the branches 
converge at the point where 0 is written into the RO as a function return value, and 
then the function ends. 


ARM64 
Listing 1.88: Non-optimizing GCC 4.9.1 ARM64 

.LC0: 

.string "Enter X:" 
.LC1: 

.string "sd" 
.LC2: 

.string "You entered %d...\n" 
.LC3: 

.string "What you entered? Huh?" 
f6: 
; save FP and LR in stack frame: 

stp x29, x30, [sp, -32]! 
; set stack frame (FP=SP) 

add x29, sp, 0 


; load pointer to the "Enter X:" string: 
adrp x0, .LCO 


81(PowerPC, ARM) Branch if Equal 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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add x0, x0, :1012:.LC0 
bl puts 

; load pointer to the "%d" string: 
adrp x0, .LC1 


add x0, x0, :lo12:.LC1 
; calculate address of x variable in the local stack 
add x1, x29, 28 
bl . isoc99 scanf 
; scanf() returned result in WO. 
; check it: 
cmp w0, 1 


; BNE is Branch if Not Equal 

so if WO<>1, jump to L2 will be occurred 
bne .L2 

; at this moment W0-1, meaning no error 

; load x value from the local stack 
ldr wl, [x29,28] 

load pointer to the "You entered %d...\n" string: 
adrp x0, .LC2 


add x0, x0, :1012:.LC2 
bl printf 

; Skip the code, which print the "What you entered? Huh?" string: 
b .L3 


.L2: 
; load pointer to the "What you entered? Huh?" string: 
adrp x0, .LC3 


add x0, x0, :1012:.LC3 
bl puts 

.L3: 

; return 0 
mov w0, 0 

; restore FP and LR: 
ldp x29, x30, [sp], 32 
ret 


Code flow in this case forks with the use of CMP/BNE (Branch if Not Equal) instructions 
pair. 


MIPS 


Listing 1.89: Optimizing GCC 4.4.5 (IDA) 


.text:004006A0 main: 
.text:004006A0 


.text:004006A0 var 18 = -0x18 

.text:004006A0 var 10 - -0x10 

.text:004006A0 var 4 = -4 

. text: 004006A0 

. text: 004006A0 lui $gp, 0x42 
.text:004006A4 addiu  $sp, -0x28 

. text : 004006A8 li $gp, 0x418960 
.text:004006AC SW $ra, Ox28+var_4($sp) 
.text:004006B0 SW $gp, Ox28+var_ 18($sp) 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


124 


. text: 004006B4 la $t9, puts 

. text: 004006B8 lui $a0, 0x40 

.text:004006BC jalr $t9 ; puts 

.text:004006C0 la $a0, aEnterX # "Enter X:" 

. text: 004006C4 lw $gp, 0x28«var 18($sp) 

.text:004006C8 lui $a0, 0x40 

.text:004006CC la $t9, — isoc99 scanf 

.text:004006D0 la $a0, aD H "sd" 

.text:004006D4 jalr $t9 ; isoc99 scanf 

.text:004006D8 addiu $al, $sp, 0x28-var 10 # branch delay slot 

.text:004006DC li $v1, 1 

.text:004006E0 lw $gp, Ox28+var_18($sp) 

. text: 004006E4 beq $vO, $v1, loc 40070C 

. text: 004006E8 or gat, $zero # branch delay slot, NOP 

.text:004006EC la $t9, puts 

.text:004006F0 lui $a0, 0x40 

.text:004006F4 jalr $t9 ; puts 

. text: 004006F8 la $a0, aWhatYouEntered # "What you entered? 

2u 

text: 004006FC lw $ra, 0x28+var_4($sp) 

.text:00400700 move $v0, $zero 

. text: 00400704 jr $ra 

.text:00400708 addiu  $sp, 0x28 

.text:0040070C loc 40070C: 

.text:0040070C la $t9, printf 

.text:00400710 lw $al, Ox28+var_10($sp) 

.text:00400714 lui $a0, 0x40 

.text:00400718 jalr $t9 ; printf 

.text:0040071C la $a0, aYouEnteredD # "You entered 
%d... Nn" 

text: 00400720 lw $ra, 0x28+var_4($5p) 

.text:00400724 move $v0, $zero 

.text:00400728 jr $ra 

.text:0040072C addiu  $sp, 0x28 


scanf() returns the result of its work in register $VO. lt is checked at address 
0x004006E4 by comparing the values in $VO with $V1 (1 has been stored in $V1 
earlier, at 0x004006DC). BEQ stands for "Branch Equal”. If the two values are equal 
(i.e., success), the execution jumps to address 0x0040070C. 


Exercise 


As we can see, the JNE/JNZ instruction can be easily replaced by the JE/JZ and vice 
versa (or BNE by BEQ and vice versa). Butthen the basic blocks must also be swapped. 
Try to do this in some of the examples. 


1.12.5 Exercise 
* http://challenges.re/53 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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1.13 Worth noting: global vs. local variables 


Now that you know that global variables are filling with zeroes by OS at start (1.12.3 
on page 101, [ISO/IEC 9899:TC3 (C C99 standard), (2007)6.7.8p10]), but local vari- 
ables are not (1.9.4 on page 50). 


Sometimes, you have a global variable that you forgot to initialize and your program 
relies on the fact that it has zero at start. Then you edit a program and move the 
global variable into a function to make it local. It wouldn't be zeroed at initialization 
anymore and this can result in nasty bugs. 


1.14 Accessing passed arguments 


Now we figured out that the caller function is passing arguments to the callee via 
the stack. But how does the callee access them? 


Listing 1.90: simple example 


#include <stdio.h> 


int f (int a, int b, int c) 


{ 
return a*b+c; 

Fi 

int main() 

{ 
printf ("%d\n", f(1, 2, 3)); 
return 0; 

yi 

1.14.1 x86 

MSVC 


Here is what we get after compilation (MSVC 2010 Express): 
Listing 1.91: MSVC 2010 Express 


_TEXT SEGMENT 


_ag = 8 ; size = 4 

_b$ = 12 ; size = 4 

_c$ = 16 ; size = 4 

_f PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
imul eax, DWORD PTR _b$[ebp] 
add eax, DWORD PTR c$[ebp] 
pop ebp 
ret 0 

f ENDP 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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main PROC 
push ebp 
mov ebp, esp 


push 3 ; 3rd argument 
push 2 ; 2nd argument 
push 1 ; Ist argument 


call f 
add esp, 12 
push eax 
push OFFSET $SG2463 ; '%d', 0aH, 00H 
call | printf 
add esp, 8 
; return 0 
xor eax, eax 
pop ebp 
ret 0 

main  ENDP 


What we see is that the main() function pushes 3 numbers onto the stack and calls 
f(int,int,int). 


Argument access inside f() is organized with the help of macros like: 

. a$ = 8, in the same way as local variables, but with positive offsets (addressed 
with plus). So, we are addressing the outer side of the stack frame by adding the 
. a$ macro to the value in the EBP register. 


Then the value of a is stored into EAX. After IMUL instruction execution, the value in 
EAX is a product of the value in EAX and the content of b. 


After that, ADD adds the value in c to EAX. 


The value in EAX does not need to be moved: it is already where it must be. On 
returning to caller, it takes the EAX value and uses it as an argument to printf(). 


MSVC + OllyDbg 


Let's illustrate this in OllyDbg. When we trace to the first instruction in f() that 
uses one of the arguments (first one), we see that EBP is pointing to the stack frame, 
which is marked with a red rectangle. 


The first element of the stack frame is the saved value of EBP, the second one is RA, 
the third is the first function argument, then the second and third ones. 


To access the first function argument, one needs to add exactly 8 (2 32-bit words) to 
EBP. 


OllyDbg is aware about this, so it has added comments to the stack elements like 
"RETURN from” and “Argl = ...", etc. 


N.B.: Function arguments are not members of the function's stack frame, they are 
rather members of the stack frame of the caller function. 


Hence, OllyDbg marked "Arg" elements as members of another stack frame. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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CPU - ma read, module ex lO) x| 
q P ^ 


55 PUSH EBP 

SBEC MOU EBP,ESP 

2845 88 MOU EAX, DWORD PTR SS: CARG. 1] 
GFAF4S ØC IMUL EAX, DWORD PTR SS: [ARG. 2] 
ADD EAX, DWORD PTR SS: CARG. 3] 
POP EBP 

RETN 

INT3 

PUSH_EBP 

MOU EBP,ESP 

PUSH 3 

PUSH 2 

PUSH 1 

CALL 96201966 

ADD ESP, BC 


ga980061 
BB22DCFS 
EFDEGOD 

' BB4EFDSC 
> BB4EFDSC 


' 00201003 00201003 


BLFFFFFFFF) 
BLFFFFFFFF) 
Bt FFFFFFFF) 
BLFFFFFFFF) 
TEFDDaBatFFF) 


Duo m mmmmmm rir ri 


Stack [004EFD64]=1 ò E ? 
EAX=00192880 a at FFFFFFFF) 


5000900000 ERROR 


ccc 


Figure 1.23: OllyDbg: inside of f () function 


GCC 
Let's compile the same in GCC 4.4.1 and see the results in IDA: 


Listing 1.92: GCC 4.4.1 


public f 
f proc near 


arg 0 = dword ptr 8 
arg 4 = dword ptr OCh 


arg 8 = dword ptr 10h 
push ebp 
mov ebp, esp 
mov eax, [ebp«arg 0] ; lst argument 
imul eax, [ebptarg 4] ; 2nd argument 
add eax, [ebptarg 8] ; 3rd argument 
pop ebp 
retn 

f endp 
public main 

main proc near 


var 10 - dword ptr -10h 


var C = dword ptr -0Ch 
var 8 = dword ptr -8 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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sub 
mov 
mov 
mov 
call 
mov 
mov 
mov 
call 
mov 
leave 
retn 
main endp 


esp, 10h 

[esp-10h-var 8], 3 ; 3rd argument 
[esp-10h-var C], 2 ; 2nd argument 
[esp-10h-var 10], 1 ; 1st argument 
f 

edx, offset aD ; "“%d\n" 
[esp-10h-var C], eax 
[esp-10h-var 10], edx 

| printf 

eax, 0 


The result is almost the same with some minor differences discussed earlier. 


The stack pointer is not set back after the two function calls(f and printf), because 
the penultimate LEAVE (.1.6 on page 1299) instruction takes care of this at the end. 


1.14.2 x64 


The story is a bit different in x86-64. Function arguments (first 4 or first 6 of them) 
are passed in registers i.e. the callee reads them from registers instead of reading 
them from the stack. 


MSVC 


Optimizing MSVC: 


Listing 1.93: Optimizing MSVC 2012 x64 


$5G2997 DB 


main PROC 
sub 
mov 
lea 
lea 
call 
lea 
mov 
call 
xor 
add 
ret 

main ENDP 


f PROC 
; ECX - 
; EDX - 
; R8D - 
imul 
lea 


%d', OaH, 00H 


rsp, 40 

edx, 2 

r8d, QWORD PTR [rdx+1] ; R8D=3 
ecx, QWORD PTR [rdx-1] ; ECX=1 
f 

rcx, OFFSET FLAT:$SG2997 ; '%d' 
edx, eax 

printf 

eax, eax 

rsp, 40 

0 


lst argument 

2nd argument 

3rd argument 

ecx, edx 

eax, DWORD PTR [r8+rcx] 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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ret 0 
f ENDP 


As we can see, the compact function f() takes all its arguments from the registers. 


The LEA instruction here is used for addition, apparently the compiler considered it 
faster than ADD. 


LEA is also used in the main() function to prepare the first and third f () arguments. 
The compiler must have decided that this would work faster than the usual way of 
loading values into a register using MOV instruction. 


Let's take a look at the non-optimizing MSVC output: 
Listing 1.94: MSVC 2012 x64 


f proc near 


; shadow space: 


arg 0 - dword ptr 8 
arg 8 - dword ptr 10h 
arg 10 - dword ptr 18h 
; ECX - 1st argument 
; EDX - 2nd argument 
; R8D - 3rd argument 
mov [rsptarg 10], r8d 
mov [rsptarg 8], edx 
mov [rsptarg 0], ecx 
mov eax, [rsp«arg 0] 
imul eax, [rsp«arg 8] 
add eax, [rspt+arg 10] 
retn 
f endp 
main proc near 
sub rsp, 28h 
mov r8d, 3 ; 3rd argument 
mov edx, 2 ; 2nd argument 
mov ecx, 1 ; 1st argument 
call f 
mov edx, eax 
lea rcx, $SG62931 ; "d\n" 
call printf 
; return 0 
xor eax, eax 
add rsp, 28h 
retn 
main endp 


It looks somewhat puzzling because all 3 arguments from the registers are saved to 
the stack for some reason. This is called “shadow space" 9?: every Win64 function 


82MSDN 
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may (but is not required to) save all 4 register values there. This is done for two 
reasons: 1) it is too lavish to allocate a whole register (or even 4 registers) for an 
input argument, so it will be accessed via stack; 2) the debugger is always aware 
where to find the function arguments at a break $. 


So, some large functions can save their input arguments in the "shadow space" if 
they want to use them during execution, but some small functions (like ours) may 
not do this. 


It is a caller responsibility to allocate "shadow space" in the stack. 


GCC 
Optimizing GCC generates more or less understandable code: 


Listing 1.95: Optimizing GCC 4.4.6 x64 


f: 
; EDI - 1st argument 
; ESI - 2nd argument 
; EDX - 3rd argument 
imul esi, edi 
lea eax, [rdx+rsi] 
ret 
main: 
sub rsp, 8 
mov edx, 3 
mov esi, 2 
mov edi, 1 
call f 
mov edi, OFFSET FLAT:.LCO ; "%d\n" 
mov esi, eax 
xor eax, eax ; number of vector registers passed 
call printf 
xor eax, eax 
add rsp, 8 
ret 


Non-optimizing GCC: 
Listing 1.96: GCC 4.4.6 x64 


f: 
; EDI - 1st argument 
; ESI - 2nd argument 
; EDX - 3rd argument 
push rbp 
mov rbp, rsp 
mov DWORD PTR [rbp-4], edi 
mov DWORD PTR [rbp-8], esi 
mov DWORD PTR [rbp-12], edx 
mov eax, DWORD PTR [rbp-4] 

83MSDN 
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imul eax, DWORD PTR [rbp-8] 


add eax, DWORD PTR [rbp-12] 
leave 
ret 
main: 
push rbp 
mov rbp, rsp 
mov edx, 3 
mov esi, 2 
mov edi, 1 
call f 
mov edx, eax 
mov eax, OFFSET FLAT:.LCO ; "%d\n" 
mov esi, edx 
mov rdi, rax 
mov eax, 0 ; number of vector registers passed 
call printf 
mov eax, 0 
leave 
ret 


There are no "shadow space" requirements in System V *NIX ([Michael Matz, Jan Hu- 
bicka, Andreas Jaeger, Mark Mitchell, System V Application Binary Interface. AMD64 
Architecture Processor Supplement, (2013)] 84), but the callee may want to save its 
arguments somewhere in case of registers shortage. 


GCC: uint64 t instead of int 


Our example works with 32-bit int, that is why 32-bit register parts are used (prefixed 
by E-). 


It can be altered slightly in order to use 64-bit values: 


#include <stdio.h> 
#include <stdint.h> 


uint64 t f (uint64 t a, uint64 t b, uint64 t c) 


1 
return a*b+c; 
i 
int main() 
{ 
printf ("%lld\n", f(0x1122334455667788, 
0x1111111122222222, 
0x3333333344444444)); 
return 0; 
ur 


8^Also available as  https://software.intel.com/sites/default/files/article/402129/ 
mpx- Linux64- abi. pdf 
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GCC 4.4.6 x64 


main 


main 


lst argument 


registers passed 


Listing 1.97: Optimizing 
proc near 
imul rsi, rdi 
lea rax, [rdx«rsi] 
retn 
endp 
proc near 
sub rsp, 8 
mov rdx, 3333333344444444h ; 3rd argument 
mov rsi, 1111111122222222h ; 2nd argument 
mov rdi, 1122334455667788h ; 
call f 
mov edi, offset format ; "%lld\n" 
mov rsi, rax 
xor eax, eax ; number of vector 
call _printf 
xor eax, eax 
add rsp, 8 
retn 
endp 


The code is the same, but this time the full size registers (prefixed by R-) are used. 


1.14.3 ARM 
Non-optimizing Keil 6/2013 (ARM mode) 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


000000A4 
000000A8 
000000AC 


000000B0 
000000B0 
000000B4 
000000B8 
000000BC 
000000C0 
000000C4 
000000C8 
000000CC 
000000D0 
000000D4 
000000D8 


00 
93 
1E 


30 
21 
FF 


AO El MOV R3, RO 
20 EO MLA RO, R3, R1, R2 
2F El BX LR 
main 
2D E9 STMFD  SP!, {R4,LR} 
AQ E3 MOV R2, #3 
A0 E3 MOV R1, #2 
AO E3 MOV RO, #1 
FF EB BL f 
AO El MOV R4, RO 
AO El MOV R1, R4 
8F E2 ADR RO, aD 0 ; "Ssd\n" 
00 EB BL . 2printf 
AO E3 MOV RO, £0 
BD E8 LDMFD SP!, {R4,PC} 


The main() function simply calls two other functions, with three values passed to 
the first one —(f()). 


As was noted before, in ARM the first 4 values are usually passed in the first 4 regis- 
ters (RO-R3). 


The f () function, as it seems, uses the first 3 registers (RO-R2) as arguments. 
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The MLA (Multiply Accumulate) instruction multiplies its first two operands (R3 and 
R1), adds the third operand (R2) to the product and stores the result into the zeroth 
register (R0), via which, by standard, functions return values. 


Multiplication and addition at once (Fused multiply-add) is a very useful operation. 
By the way, there was no such instruction in x86 before FMA-instructions appeared 
in SIMD $5, 


The very first MOV R3, RO, instruction is, apparently, redundant (a single MLA in- 
struction could be used here instead). The compiler has not optimized it, since this 
is non-optimizing compilation. 


The BX instruction returns the control to the address stored in the LR register and, if 
necessary, switches the processor mode from Thumb to ARM or vice versa. This can 
be necessary since, as we can see, function f () is not aware from what kind of code 
it may be called, ARM or Thumb. Thus, if it gets called from Thumb code, BX is not 
only returns control to the calling function, but also switches the processor mode 
to Thumb. Or not switch, if the function has been called from ARM code [ARM(R) 
Architecture Reference Manual, ARMv7-A and ARMv7-R edition, (2012)A2.3.2]. 


Optimizing Keil 6/2013 (ARM mode) 


.text:00000098 f 
.text:00000098 91 20 20 EO MLA RO, R1, RO, R2 
.text:0000009C 1E FF 2F El BX LR 


And here is the f () function compiled by the Keil compiler in full optimization mode 
(-03). 


The MOV instruction was optimized out (or reduced) and now MLA uses all input reg- 
isters and also places the result right into RO, exactly where the calling function will 
read and use it. 


Optimizing Keil 6/2013 (Thumb mode) 


.text:0000005E 48 43 MULS RO, R1 
.text:00000060 80 18 ADDS RO, RO, R2 
.text:00000062 70 47 BX LR 


The MLA instruction is not available in Thumb mode, so the compiler generates the 
code doing these two operations (multiplication and addition) separately. 


First the MULS instruction multiplies RO by R1, leaving the result in register RO. The 
second instruction (ADDS) adds the result and R2 leaving the result in register RO. 


ARM64 
Optimizing GCC (Linaro) 4.9 


85 wikipedia 
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Everything here is simple. MADD is just an instruction doing fused multiply/add (sim- 
ilar to the MLA we already saw). All 3 arguments are passed in the 32-bit parts of 
X-registers. Indeed, the argument types are 32-bit int's. The result is returned in WO. 


Listing 1.98: Optimizing GCC (Linaro) 4.9 


f: 
madd w0, w0, wl, w2 
ret 
main: 
; save FP and LR to stack frame: 
stp x29, x30, [sp, -16]! 
mov w2, 3 
mov wl, 2 
add x29, sp, 0 
mov w0, 1 
bl f 
mov wl, wO 
adrp x0, .LC7 
add x0, x0, :1012:.LC7 
bl printf 
; return 0 
mov w0, 0 
; restore FP and LR 
ldp x29, x30, [sp], 16 
ret 
.LC7: 


.string "%d\n" 


Let's also extend all data types to 64-bit uint64 t and test: 


#include <stdio.h> 
#include <stdint.h> 


uint64 t f (uint64 t a, uint64 t b, uint64 t c) 


1 
return a*b+c; 
int main() 
1 
printf ("%lld\n", f(0x1122334455667788, 
0x1111111122222222, 
0x3333333344444444)); 
return 0; 
F; 
f: 
madd x0, x0, x1, x2 
ret 
main: 
mov x1, 13396 
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adrp x0, .LC8 


stp x29, x30, [sp, -16]! 
movk x1, 0x27d0, lsl 16 
add x0, x0, :1012:.LC8 
movk x1, 0x122, lsl 32 
add x29, sp, 0 

movk x1, 0x58be, lsl 48 
bl printf 

mov w0, 0 

ldp x29, x30, [sp], 16 
ret 


.LC8: 
.string "%slld\n" 


The f() function is the same, only the whole 64-bit X-registers are now used. Long 
64-bit values are loaded into the registers by parts, this is also described here: 1.39.3 
on page 556. 


Non-optimizing GCC (Linaro) 4.9 


The non-optimizing compiler is more redundant: 


f: 
sub sp, sp, £16 
str w0, [sp,12] 
str wl, [sp,8] 
str w2, [sp,4] 


ldr wl, [sp,12] 
ldr w0, [sp,8] 


mul wl, wl, w0 
ldr wO, [sp,4] 
add wO, wl, wO 
add sp, sp, 16 
ret 


The code saves its input arguments in the local stack, in case someone (or some- 
thing) in this function needs using the WO. . .W2 registers. This prevents overwriting 
the original function arguments, which may be needed again in the future. 


This is called Register Save Area. [Procedure Call Standard for the ARM 64-bit Archi- 
tecture (AArch64), (2013)]89. The callee, however, is not obliged to save them. This 
is somewhat similar to "Shadow Space": 1.14.2 on page 129. 


Why did the optimizing GCC 4.9 drop this argument saving code? Because it did 
some additional optimizing work and concluded that the function arguments will not 
be needed in the future and also that the registers WO. . .W2 will not be used. 


We also see a MUL/ADD instruction pair instead of single a MADD. 


86Also available as http://infocenter.arm.com/help/topic/com.arm.doc.ihi0055b/IHI0055B _ 
aapcs64.pdf 
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1.14.4 MIPS 


Listing 1.99: Optimizing GCC 4.4.5 
.text:00000000 f: 
; $a0=a 
; $al=b 
; $a2=c 
.text:00000000 mult $al, $a0 
.text:00000004 mflo $v0 
. text: 00000008 jr $ra 
.text:0000000C addu $v0, $a2, $v0 ; branch delay slot 


; result is in 
.text:00000010 
.text:00000010 
.text:00000010 
.text:00000010 
.text:00000010 
.text:00000010 
.text:00000014 
.text:00000018 
.text:0000001C 
.text:00000020 
; Set c: 
.text:00000024 
; set a: 
.text:00000028 
.text:0000002C 
; Set b: 
.text:00000030 

; result in $v0 now 
.text:00000034 
.text:00000038 
.text:0000003C 
.text:00000040 
.text:00000044 


main: 


var 10 
var 4 


$vO upon return 


- -0x10 

= -4 

lui $gp, 
addiu $sp, 
la $9p, 
SW $ra, 
SW $9p, 
li $a2, 
li $a0, 
jal f 
li $al, 
lw $gp, 
lui $a0, 
lw $t9, 
la $a0, 
jalr $t9 


(__gnu_local_gp >> 16) 
-0x20 

( gnu local gp € OxFFFF) 
0x20-var 4($sp) 
0x20+var_10($sp) 


3 


1 


2 ; branch delay slot 
0x20+var_10($sp) 

($LCO >> 16) 

(printf € OxFFFF) ($gp) 

($LCO € OXFFFF) 


; take result of f() function and pass it 


; as a second argument to printf(): 


.text:00000048 
.text:0000004C 
.text:00000050 
.text:00000054 
.text:00000058 


move $al, 
lw $ra, 
move $v0, 
jr $ra 
addiu $sp, 


$vO ; 
0x20-var 4($sp) 
$zero 


branch delay slot 


0x20 ; branch delay slot 


The first four function arguments are passed in four registers prefixed by A-. 


There are two special registers in MIPS: HI and LO which are filled with the 64-bit 
result of the multiplication during the execution of the MULT instruction. 


These registers are accessible only by using the MFLO and MFHI instructions. MFLO 
here takes the low-part of the multiplication result and stores it into $VO. So the 
high 32-bit part of the multiplication result is dropped (the HI register content is not 
used). Indeed: we work with 32-bit int data types here. 


Finally, ADDU ("Add Unsigned") adds the value of the third argument to the result. 
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There are two different addition instructions in MIPS: ADD and ADDU. The difference 
between them is not related to signedness, but to exceptions. ADD can raise an 
exception on overflow, which is sometimes useful?” and supported in Ada PL, for 
instance. ADDU does not raise exceptions on overflow. 


Since C/C++ does not support this, in our example we see ADDU instead of ADD. 
The 32-bit result is left in $VO. 
There is a new instruction for us in main(): JAL ("Jump and Link"). 


The difference between JAL and JALR is that a relative offset is encoded in the first 
instruction, while JALR jumps to the absolute address stored in a register ("Jump and 
Link Register"). 


Both f() and main() functions are located in the same object file, so the relative 
address of f() is known and fixed. 


1.15 More about results returning 


In x86, the result of function execution is usually returned 9? in the EAX register. If it 
is byte type or a character (char), then the lowest part of register EAX (AL) is used. 
If a function returns a float number, the FPU register ST(0) is used instead. In ARM, 
the result is usually returned in the RO register. 


1.15.1 Attempt to use the result of a function returning void 


So, what if the main() function return value was declared of type void and not int? 
The so-called startup-code is calling main() roughly as follows: 


push envp 
push argv 
push argc 
call main 
push eax 
call exit 


In other words: 


exit (main(argc,argv,envp)); 


If you declare main() as void, nothing is to be returned explicitly (using the return 
statement), then something random, that has been stored in the EAX register at the 
end of main() becomes the sole argument of the exit() function. Most likely, there 
will be a random value, left from your function execution, so the exit code of program 
is pseudorandom. 


We can illustrate this fact. Please note that here the main() function has a void 
return type: 


87http://blog.regehr.org/archives/1154 
88See also: MSDN: Return Values (C++): MSDN 
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#include <stdio.h> 


void main() 


{ 
Fi 


printf ("Hello, world!\n"); 


Let's compile it in Linux. 


GCC 4.8.1 replaced printf() with puts() (we have seen this before: 1.5.3 on 
page 28), but that's OK, since puts() returns the number of characters printed out, 
just like printf(). Please notice that EAX is not zeroed before main()'s end. 


This implies that the value of EAX at the end of main() contains what puts() has 
left there. 


Listing 1.100: GCC 4.8.1 


.LC0: 

.string "Hello, world!" 
main: 

push ebp 

mov ebp, esp 

and esp, -16 

sub esp, 16 

mov DWORD PTR [esp], OFFSET FLAT: .LCO 

call puts 

leave 

ret 


Let' s write a bash script that shows the exit status: 


Listing 1.101: tst.sh 


#!/bin/sh 
./hello_world 
echo $? 


And run it: 


$ tst.sh 
Hello, world! 
14 


14 is the number of characters printed. The number of characters printed slips from 
printf () through EAX/RAX into "exit code". 


Another example in the book: 3.32 on page 814. 


By the way, when we decompile C++ in Hex-Rays, we can often encounter a function 
which terminated with destructor of some class: 
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call ??1CString@@QAE@XZ ; CString:: CString(void) 


mov ecx, [esp+30h+var_ C] 
pop edi 

pop ebx 

mov large fs:0, ecx 

add esp, 28h 

retn 


By C++ standard, destructor doesn't return anything, but when Hex-Rays don't know 
about it, and thinks that both destructor and this function returns int, we can see 
something like that in output: 


return CString: :~CString(&Str) ; 


1.15.2 What if we do not use the function result? 


printf() returns the count of characters successfully output, but the result of this 
function is rarely used in practice. 


It is also possible to call a function whose essence is in returning a value, and not 
use it: 


int f() 
{ 
// skip first 3 random values: 
rand(); 
rand(); 
rand(); 


// and use 4th: 
return rand(); 


ur 


The result of the rand() function is left in EAX, in all four cases. 


But in the first 3 cases, the value in EAX is just not used. 


1.15.3 Returning a structure 


Let's go back to the fact that the return value is left in the EAX register. 


That is why old C compilers cannot create functions capable of returning something 
that does not fit in one register (usually int), but if one needs it, one have to return 
information via pointers passed as function's arguments. 


So, usually, if a function needs to return several values, it returns only one, and all 
the rest—via pointers. 


Now it has become possible to return, let's say, an entire structure, but that is still 
not very popular. If a function has to return a large structure, the caller must allocate 
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it and pass a pointer to it via the first argument, transparently for the programmer. 
That is almost the same as to pass a pointer in the first argument manually, but the 
compiler hides it. 


Small example: 


struct s 
1 
int a; 
int b; 
int c; 
ur 
struct s get some values (int a) 
1 
struct s rt; 
rt.a=a+1; 
rt.b=a+2; 
rt.c=a+3; 
return rt; 
ur 


...what we got (MSVC 2010 /0x): 


$13853 = 8 ; size = 4 
_a$ = 12 ; size = 4 
?get_some_values@@YA?AUS@@H@Z PROC ; get some values 
mov ecx, DWORD PTR a$[esp-4] 
mov eax, DWORD PTR $T3853[esp-4] 
lea edx, DWORD PTR [ecx+1] 
mov DWORD PTR [eax], edx 
lea edx, DWORD PTR [ecx+2] 
add ecx, 3 
mov DWORD PTR [eax+4], edx 
mov DWORD PTR [eax+8], ecx 
ret 0 
?get some values@@YA?AUS@@H@Z ENDP ; get some values 


The macro name for internal passing of pointer to a structure here is $T3853. 
This example can be rewritten using the C99 language extensions: 


struct s 
1 
int a; 
int b; 
int C; 
ur 


struct s get some values (int a) 


1 


return (struct s){.a=a+1, .b=a+2, .c=a+3}; 
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y 


Listing 1.102: GCC 4.8.1 


get some values proc near 


ptr to struct = dword ptr 4 

a = dword ptr 8 
mov edx, [esp+al 
mov eax, [esp*ptr to struct] 
lea ecx, [edx+1] 
mov [eax], ecx 
lea ecx, [edx+2] 
add edx, 3 
mov [eax+4], ecx 
mov [eax+8], edx 
retn 


get some values endp 


As we see, the function is just filling the structure's fields allocated by the caller func- 
tion, as if a pointer to the structure has been passed. So there are no performance 
drawbacks. 


1.16 Pointers 


1.16.1 Returning values 


Pointers are often used to return values from functions (recall scanf() case (1.12 
on page 87)). 


For example, when a function needs to return two values. 


Global variables example 


#include <stdio.h> 


void f1 (int x, int y, int *sum, int *product) 
1 
*sum-xty ; 
*product=x*y; 
ur 


int sum, product; 
void main() 
f1(123, 456, &sum, &product); 


printf ("sum=%d, product=%d\n", sum, product); 
}; 
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This compiles to: 


Listing 1.103: Optimizing MSVC 2010 (/Ob0) 


COMM _ product: DWORD 
COMM _ sum: DWORD 
$5G2803 DB 'sum=%d, product=%d', OaH, OOH 
_x$ = 8 ; size = 4 
_y$ = 12 ; size = 4 
_sum$ = 16 ; size = 4 
_product$ = 20 ; size = 4 
fl PROC 
mov ecx, DWORD PTR y$[esp-4] 
mov eax, DWORD PTR _x$[esp-4] 
lea edx, DWORD PTR [eax+ecx] 
imul eax, ecx 
mov ecx, DWORD PTR _product$[esp-4] 
push esi 
mov esi, DWORD PTR _sum$[esp] 
mov DWORD PTR [esi], edx 
mov DWORD PTR [ecx], eax 
pop esi 
ret 0 
fl ENDP 
main PROC 
push OFFSET product 
push OFFSET sum 
push 456 ; 000001c8H 
push 123 ; 0000007bH 
call .f1 
mov eax, DWORD PTR product 
mov ecx, DWORD PTR sum 
push eax 
push ecx 
push OFFSET $SG2803 
call DWORD PTR imp printf 
add esp, 28 
xor eax, eax 
ret 0 
main  ENDP 
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Let's see this in OllyDbg: 


CPU - main thread, module global 


63 29229700 
68 ETT 

6E494714 ASCII "H(F" 
aaaaaaoa 

aaaaaaaa 

GG3GFSE4 

BO30F92C 

aaanaaat 

96873398 global. ð 


60087102A global 102A 


ØLFFFFFFFF) 

t ØLFFFFFFFF) 
@(FFFFFFFF) 
atFFFFFFFF) 
?EFDDaaatFFF) 
@(FFFFFFFF) 


6A 7B P 

ES CAFFFFFF |CALL 00871000 

Al 38338700 |MOU ERX,DWORD PTR DS: [8373388] 
3B0D 24338701 MOV ECX, DWORD PTR DS: [873384] 
5a PUSH EAX 

51 PUSH ECX 

68 00202700 |PUSH OFFSET 00873000 

FF15 AQZASTAI CALL DWORD PTR DS: [<8MSUCR1B6.printf>] 
ADD ESP, 1C 

XOR EAX, EAX 

RETN 


4Doo m mmrmmnimi 


IDR DARDO 


n 


RETURN from alob. 
ASCII ”pNF” 


9-A Th} 


aoc 
mc 


etc 


TT-TToP- Tu] 
T 


T 
DD ¢ 
Ted 


Figure 1.24: OllyDbg: global variables addresses are passed to f1() 


First, global variables' addresses are passed to f1(). We can click "Follow in dump" 
on the stack element, and we can see the place in the data segment allocated for 
the two variables. 
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These variables are zeroed, because non-initialized data (from BSS) is cleared before 
the execution begins, [see ISO/IEC 9899:TC3 (C C99 standard), (2007) 6.7.8p10]. 


They reside in the data segment, we can verify this by pressing Alt-M and reviewing 
the memory map: 


Address 
aaacaaan 
99060008 
99070000 
00159000 
aasaDaan 
aasaEann 
99460000 
aa4naana 
aaeBaaan 
00870000 
00871000 
00872000 
73000 


aas 

00874000 
GESE00OA 
6E3E1000 
6E493000 
6E499000 
6E49A00A 
75500000 
75501000 
75504000 
75505000 
755E00GO 
755E1000 
7562E000 
75633000 


Size 

009004090 
90001000 
90067090 
99007008 
009001000 
99962000 
aaaasana 
90007008 
aaaacaan 
90901006 
90001006 
90001008 
90001008 
90001008 
90001006 
aaapeaoa 
aaaa6ana 
90001900 
aaaasaaa 
90001006 
99903008 
99001900 
aaaasaaa 
90001006 
00040090 
aaaasaoa 
aaaasaaa 


global 
global 
global 
global 
global 
MSUCR100 
MSUCR100 
MSUCR100 
MSUCR100 
MSUCR100 
Mod_755D 


Mod_755E 


etext 
.rdata 
.data 
.reloc 


.teut 
.data 
«PSro 
.reloc 


Stack of main thread 
Heap 


Default heap 
PE header 


Relocat ions 

PE header 

Code, imports, exports 
Data 

Resources. 

Re locat ions 

PE header 


PE header 


p7 77222222727 
EEEEEE € 


= 


m 


23700770007207 
m 


D 
o 
u 


Section | Contains 


Initial] Mapped as al 


Figure 1.25: OllyDbg: memory map 


C:\WindowssSystem32s Loc 
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Let's trace (F7) to the start of f1(): 


CPU - main thread, module global 


C2 a Y 


MOU EAX RD PTR SS:LRRG.11 


AX, DWO! 
LER EDX, LECX*ERX1 
IMUL EAX, ECX 
MOV ECX, DWORD PTR SS:[ARG.4] 
PUSH ESI 
MOU ESI, DWORD PTR SS:CARG.3] 
MOV DWORD PTR DS:[ESI], EDX 
MOU DWORD PTR DS: CECKI,EAX 
POP ESI 


CII "H(F" 


' BasarspDs 


Quom 


DOD-DOr-D uum 


slo 
00871000 < 


t BLFFFFFFFF) 
t B(FFFFFFFF) 
t vEFDDBBBLFFF) 
: B(FFFFFFFF) 


8 
a I zt 4 
Stack _[0030FSE0]=000901C: 
ECX=6E494714 (MSUCR190.__initenv) 
Local call from 871831 


IDAONDIVO m mmmmmmmm 


o 
e 


PE, GE, LE) 


tbn 


6 
HIF hNF RETURN from glob. 


ASCII "pNF'" 


Figure 1.26: OllyDbg: f1() starts 


Two values are visible in the stack: 456 (0x1C8) and 123 (0x7B), and also the ad- 
dresses of the two global variables. 
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Let's trace until the end of f1(). In the left bottom window we see how the results 
of the calculation appear in the global variables: 


CPU - main thread, module global (mf xl 
M ^ 


SB4C24 MOU ECX, DWORD PTR SS: CARG.2] 
MOV EAX, DWORD PTR SS: CARG. 1] 
LEA EDX, CECK+EAX] 

IMUL EAX, ECX 

MOV ECX, DWORD PTR SS:[ARG.4] 
PUSH ESI 

MOU ESI,DWORD PTR SS:LRRG.31 
MOU DWORD PTR DS: [ESIJ,EDX 
MOU DWORD PTR DS: CECK],EAX 
POP ESI 


) Dae D 


: B(FFFFFFFF) 
it B(FFFFFFFF) 
BLFFFFFFFF) 
BLFFFFFFFF) 
7EFDDGBOLFFF) 

OCFFFFFFFF) 


00873388 


Top of stack LOBGSOFSD4 
ESI=3lobal. 90873284 


DOE 


El 
m/E5m/ES 


RETURN from alob 
ASCII "pNF” 


Figure 1.27: OllyDbg: f1() execution completed 
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Now the global variables' values are loaded into registers ready for passing to printf() 
(via the stack): 


CPU - main thread, module global (Oj x] 
~ ^ 


cc 


cc INT3 

68 22338700 |PUSH OFFSET 00873388 

68 242239700 |PUSH OFFSET 00873384 

68 CS818888 |PUSH 103 

6A 7B PUSH 7B 

ES CAFFFFFF | CALL 00871000 

Al 22229700 | MOU EAX, DWORD PTR DS: [873388] 
SpaD me MOV ECX, DWORD PTR DS: [873384] 
5a PUSH EAX 


51 PUSH ECX 

8 go299709 | PUSH OFFSET 00873000 fc Ico Es jit BLFFFFFFFF) 
FF15 pazara CALL DWORD PTR DS:L«&MSUCR188. printf >] E.1 p jit OCFFEFFFFF) 
8964 10 ADD ESP,1C no t 


, at FFFFFFFF) 
XOR EAX, EAX BCFFFFFFFF) 


7EFDDOBO(FFF) 
OCFFFFFFFF) 


. D L] 
Stack [0030F8D08]=global. 00871036 
EAX=0000D818 (decimal 56088. ) 


IOAMND 


SUCCESS 
S,PE,GE,G) 


mn 
paj 


m/ESm/ES 
RETURN from glob. 
ASCII ”pNF” 


Figure 1.28: OllyDbg: global variables’ values are passed into printf() 


Local variables example 
Let's rework our example slightly: 


Listing 1.104: now the sum and product variables are local 


void main() 

{ 
int sum, product; // now variables are local in this function 
f1(123, 456, &sum, &product); 
printf ("sum=%d, product=%d\n", sum, product); 

$; 


f1() code will not change. Only the code of main() will do: 


Listing 1.105: Optimizing MSVC 2010 (/Ob0) 


| product$ = -8 ; size = 4 

_sum$ = -4 ; size = 4 

main PROC 

; Line 10 
sub esp, 8 

; Line 13 
lea eax, DWORD PTR _product$[esp+8] 
push eax 
lea ecx, DWORD PTR _sum$[esp+12] 
push ecx 
push 456 ; 000001c8H 
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push 
call 
; Line 14 
mov 
mov 
push 
push 
push 
call 
; Line 15 
xor 
add 
ret 


123 ; 0000007bH 
_f1 


edx, DWORD PTR _product$[esp+24] 
eax, DWORD PTR _sum$[esp+24] 

edx 

eax 

OFFSET $SG2803 

DWORD PTR _imp_ printf 


eax, eax 
esp, 36 
0 
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Let's look again with OllyDbg. The addresses of the local variables in the stack are 
Ox2EF854 and 0x2EF858. We see how these are pushed into the stack: 


CPU - main thread, module local 


a ABZEF SSS 
CLOCAL. 11 QB4DCDFE 
aaaaaoaa 
GO2EF85a 
^ GBZEF89S 
001 
e a 

^ @GA61G2B local.t 


a 
{ 
f 


Ban 
OLFFFFFFFF) 
rintf> * 1 BL FFFFFFFF) 
Pelee? à : BLFFFFFFFF) 


KEI R 
Stack [GG2EFS4C 
EAX=002EF858 


GG2EFS6C 


Figure 1.29: OllyDbg: local variables’ addresses are pushed into the stack 
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f1() starts. So far there is only random garbage in the stack at Ox2EF854 and 
Ox2EF858: 


SBS424 a8 DU » DWORD P n ES 
SB4424 BC MOY EAX, DWORD PTR SS:LRRG.31 
56 PUSH ESI 

887424 08 MOV ESI, DWORD PTR SS: [ARG.1] 
SDacié E EDX*ESIl 


MOU EAX, DWORD PTR SS: CARG. 4] 
MOU DWORD PTR DS: [EAXJ,ESI 


On61880 
(FFFFFFFE) 
( 


a 
a 
a 


IN : BLEFFEFEFE) 
cost MEE "I at T Eon 
Stack L002EF848]=000001C8 (decimal 456.) B GŠ | Sobit B(FFFFFFFF) 
Local call from ORS1033 


Figure 1.30: OllyDbg: f1() starting 
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f1() completes: 


SS: ERRG. 11 


MOU DWORD 11, ECX 
MOU EAX, DI : LARG. 41 
0 ORD P ¿J ESI 


BLFFFFFFFF) 
acFFFFFFFF) 
7EFOD@GG( FFF) 
G(FFFFFFFF) 


A 
aaaaaics| “6 
BOZEFS5S xo. 


DOCEFOGA aaaaDBis 
99060243 


Top of stack BOZEFS 
EST=a0000818 (decimal 56088. J 


DANMUDDO 


pipi agas 
A,NS,PE,GE, 


TADA 
C C. C 


Figure 1.31: OllyDbg: f1() completes execution 


We now find 0xDB18 and 0x243 at addresses 0x2EF854 and 0x2EF858. These values 
are the f1() results. 


Conclusion 


f1() could return pointers to any place in memory, located anywhere. 
This is in essence the usefulness of the pointers. 


By the way, C++ references work exactly the same way. Read more about them: 
(3.21.3 on page 705). 


1.16.2 Swap input values 
This will do the job: 


#include <memory.h> 
#include <stdio.h> 


void swap bytes (unsigned char* first, unsigned char* second) 


{ 
unsigned char tmpl; 
unsigned char tmp2; 


tmpl=*first; 
tmp2=*second; 


*first=tmp2; 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


152 


*second=tmp1; 


}; 
int main() 
{ 
// copy string into heap, so we will be able to modify it 
char *s=strdup("string"); 
// swap 2nd and 3rd characters 
swap bytes (s+1, s+2); 
printf ("%s\n", s); 
}; 


As we can see, bytes are loaded into lower 8-bit parts of ECX and EBX using MOVZX 
(so higher parts of these registers will be cleared) and then bytes are written back 
swapped. 


Listing 1.106: Optimizing GCC 5.4 


swap_bytes: 
push ebx 
mov edx, DWORD PTR [esp+8] 
mov eax, DWORD PTR [esp+12] 


movzx ecx, BYTE PTR [edx] 
movzx ebx, BYTE PTR [eax] 


mov BYTE PTR [edx], bl 
mov BYTE PTR [eax], cl 
pop ebx 

ret 


Addresses of both bytes are taken from arguments and through execution of the 
function are located in EDX and EAX. 


So we use pointers: probably, there is no better way to solve this task without them. 


1.17 GOTO operator 


The GOTO operator is generally considered as anti-pattern, see [Edgar Dijkstra, Go To 
Statement Considered Harmful (1968)9?]. Nevertheless, it can be used reasonably, 
see [Donald E. Knuth, Structured Programming with go to Statements (1974)?9] 9. 


Here is a very simple example: 


#include <stdio.h> 


int main() 


{ 
printf ("begin\n"); 


89http://yurichev.com/mirrors/Dijkstra68.pdf 
90http://yurichev.com/mirrors/KnuthStructuredProgrammingGoTo.pdf 
21 Dennis Yurichev, C/C++ programming language notes] also has some examples. 
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goto exit; 

printf ("skip me!\n"); 
exit: 

printf ("end\n"); 
F; 


Here is what we have got in MSVC 2012: 
Listing 1.107: MSVC 2012 


$SG2934 DB 'begin', OaH, 00H 
$5G2936 DB ‘skip me!', OaH, 00H 
$SG2937 DB 'end', O0aH, 00H 
main PROC 
push ebp 
mov ebp, esp 
push OFFSET $5G2934 ; 'begin' 
call | printf 
add esp, 4 
jmp SHORT $exit$3 
push OFFSET $5G2936 ; ‘skip me!' 
call | printf 
add esp, 4 
$exit$3: 
push OFFSET $SG2937 ; 'end' 
call | printf 
add esp, 4 
xor eax, eax 
pop ebp 
ret 0 
main  ENDP 


The goto statement has been simply replaced by a JMP instruction, which has the 
same effect: unconditional jump to another place. The second printf() could be 
executed only with human intervention, by using a debugger or by patching the 
code. 
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This could also be useful as a simple patching exercise. Let's open the resulting 
executable in Hiew: 


'skip me!' 


Figure 1.32: Hiew 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


155 


Place the cursor to address JMP (0x410), press F3 (edit), press zero twice, so the 
opcode becomes EB 00: 


Figure 1.33: Hiew 


The second byte of the JMP opcode denotes the relative offset for the jump, 0 means 
the point right after the current instruction. 


So now JMP not skipping the second printf() call. 


Press F9 (save) and exit. Now if we run the executable we will see this: 


Listing 1.108: Patched executable output 


C:\...>goto.exe 


begin 
skip me! 
end 


The same result could be achieved by replacing the JMP instruction with 2 NOP in- 
structions. 


NOP has an opcode of 0x90 and length of 1 byte, so we need 2 instructions as JMP 
replacement (which is 2 bytes in size). 


1.17.1 Dead code 


The second printf() call is also called “dead code” in compiler terms. 


This means that the code will never be executed. So when you compile this example 
with optimizations, the compiler removes “dead code”, leaving no trace of it: 
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Listing 1.109: Optimizing MSVC 2012 


$SG2981 DB 'begin', OaH, 00H 
$SG2983 DB ‘skip me!', OaH, 00H 
$SG2984 DB 'end', OaH, 00H 
main PROC 

push OFFSET $SG2981 ; 'begin' 

call | printf 

push OFFSET $SG2984 ; 'end' 
$exit$4: 

call | printf 

add esp, 8 

xor eax, eax 

ret 0 
main  ENDP 


However, the compiler forgot to remove the "skip me!" string. 


1.17.2 Exercise 


Try to achieve the same result using your favorite compiler and debugger. 


1.18 Conditional jumps 


1.18.1 Simple example 


#include <stdio.h> 


void f signed (int a, int b) 


1 
if (a>b) 
printf ("a>b\n"); 
if (a==b) 
printf ("a==bWn"); 
if (a<b) 
printf ("a<b\n"); 
}; 
void f_unsigned (unsigned int a, unsigned int b) 
{ 
if (a>b) 
printf ("a>b\n"); 
if (a==b) 
printf ("a==b\n"); 
if (a<b) 
printf ("a<b\n"); 
}; 
int main() 
{ 
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f signed(1, 2); 
f unsigned(1, 2); 
return 0; 


F 


x86 
x86 + MSVC 


Here is how the f signed() function looks like: 


Listing 1.110: Non-optimizing MSVC 2010 


_ag = 8 
_b$ = 12 
_f signed PROC 
push ebp 
mov ebp, esp 


mov eax, DWORD PTR a$[ebp] 
cmp eax, DWORD PTR _b$[ebp] 
jle SHORT $LN3@f_ signed 
push OFFSET $SG737 ; 'a»b' 
call printf 
add esp, 4 
$LN3Gf signed: 
mov ecx, DWORD PTR a$[ebp] 
cmp ecx, DWORD PTR _b$[ebp] 
jne SHORT $LN2@f_ signed 
push OFFSET $SG739 ; 'a--b' 
call _ printf 
add esp, 4 
$LN2@f_signed: 
mov edx, DWORD PTR _a$[ebp] 
cmp edx, DWORD PTR _b$[ebp] 
jge SHORT $LN4@f_signed 
push OFFSET $SG741 ; 'a«b' 
call | printf 
add esp, 4 
$LNAQGf signed: 
pop ebp 
ret 0 
f signed ENDP 


The first instruction, JLE, stands for Jump if Less or Equal. In other words, if the 
second operand is larger or equal to the first one, the control flow will be passed 
to the address or label specified in the instruction. If this condition does not trigger 
because the second operand is smaller than the first one, the control flow would not 
be altered and the first printf() would be executed. The second check is JNE: Jump 
if Not Equal. The control flow will not change if the operands are equal. 


The third check is JGE: Jump if Greater or Equal—jump if the first operand is larger 
than the second or if they are equal. So, if all three conditional jumps are triggered, 
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none of the printf() calls would be executed whatsoever. This is impossible with- 
out special intervention. Now let's take a look at the f unsigned() function. The 
f unsigned() function is the same as f signed(), with the exception that the JBE 
and JAE instructions are used instead of JLE and JGE, as follows: 


Listing 1.111: GCC 


_ag = 8 ; size = 4 
_b$ = 12 ; size = 4 
f unsigned PROC 
push ebp 
mov ebp, esp 


mov eax, DWORD PTR a$[ebp] 
cmp eax, DWORD PTR _b$[ebp] 
jbe SHORT $LN3@f_unsigned 
push OFFSET $5G2761 ; 'a»b' 
call printf 
add esp, 4 

$LN3@f_unsigned: 
mov ecx, DWORD PTR a$[ebp] 
cmp ecx, DWORD PTR _b$[ebp] 
jne SHORT $LN2@f unsigned 
push OFFSET $5G2763 y 'a==b' 
call printf 
add esp, 4 

$LN2Gf unsigned: 
mov edx, DWORD PTR _a$[ebp] 
cmp edx, DWORD PTR _b$[ebp] 
jae SHORT $LN4Gf unsigned 
push OFFSET $5G2765 ; 'a«b' 
call printf 
add esp, 4 

$LN4@f_unsigned: 
pop ebp 
ret 0 

f unsigned ENDP 


As already mentioned, the branch instructions are different: JBE—/ump if Below or 
Equal and JAE—Jump if Above or Equal. These instructions (JA/JAE/JB/JBE) differ 
from JG/JGE/JL/JLE in the fact that they work with unsigned numbers. 


That is why if we see JG/JL in use instead of JA/JB or vice-versa, we can be almost 
sure that the variables are signed or unsigned, respectively. Here is also the main() 
function, where there is nothing much new to us: 


Listing 1.112: main() 


main PROC 
push ebp 
mov ebp, esp 
push 2 
push 1 
call _f signed 
add esp, 8 
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push 2 
push 1 
call _f unsigned 
add esp, 8 
xor eax, eax 
pop ebp 
ret 0 
main  ENDP 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


160 


x86 + MSVC + OllyDbg 


We can see how flags are set by running this example in OllyDbg. Let's begin with 
f unsigned(), which works with unsigned numbers. 


CMP is executed thrice here, but for the same arguments, so the flags are the same 
each time. 


Result of the first comparison: 


CPU - main thread, module ex ini x| 
A ps 


HOO EEF, ESP zr 

MOU EAX, DWORD PTR SS:CARG. 1] FEES, 

CHP EAX, DWORD PTR SS: CARG. 2] 

JBE SHORT 001A1069 

8 18201900 |PUSH OFFSET 8012018 

FELE paenlAof CALL DUORD PTR DS: [<&MSUCR100.printf>] 

MOU ECX, DWORD PTR SS:CARG. 1] 

CHP ECX, DWORD PTR SS: CARG. 21] 

JNE SHORT BO1RlO7F EIP 001A1059 

8 2üs01gog | PUSH OFFSET Boinse2o £ n Do: 

FF15 BO2O18aÍ CALL DWORD PTR DS:L4MSUCRIBB.print£?l BE EFFEEFFE) 

ADD ESP,4 ; BL FFFFFFFF) 

MOU EDX, DWORD PTR SS: CARG. 1] | Sobit OLEFEEFEEE) 
LE BO ETE Ho E bit 7EFDDOBOLFFF) 


RETURN from 


DD 


RETURN from 


ASCII "phNu'' 


Qa Qa Qa 00 00 aga aa 


Figure 1.34: OllyDbg: f unsigned(): first conditional jump 


So, the flags are: C=1, P=1, A=1, Z=0, S=1, T=0, D=0, O=0. 
They are named with one character for brevity in OllyDbg. 


OllyDbg gives a hint that the (JBE) jump is to be triggered now. Indeed, if we take a 
look into Intel manuals (12.1.4 on page 1282), we can read there that JBE is trigger- 
ing if CF=1 or ZF=1. The condition is true here, so the jump is triggered. 
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The next conditional jump: 


CPU - main thread, module ex E 


55 PUSH EBP 
8BEC MOU EBP, ESP 

8B45 08 MOU EAX, DWORD PTR SS: ARG. 1] 

3B45_ ac CMP EAX, DWORD PTR SS: CARG. 2] 

76 GE JBE SHORT 001A1069 

68 18301000 |PUSH OFFSET 80102018 

FF1S AB20180l CALL DWORD PTR DS: {<&MSUCR1O0. printf >] 

8304 04 ADD ESP,4 

8B4D 08 MOU ECX,DUORD PTR SS: CARG. 1] 

384D_00 CP EC DWORD PTR SS: LARG. 2] 

75 BE JNE SHORT OB1A107F z : 

68 20201900 |PUSH OFFSET ag1n3020 AC FFEFFFEE) 
FF15 Bü201BO! CALL DWORD PTR DS: (<&MSUCR1O0. printf >] rada 
8304 04 ADD ESP, 4 pada da, 
2B55 08 HOU EDX, DWORD PTR SS:FBRG.11 i B(FFFFFFFF) 


7EFDOGBOLFFF) 
BLFFFFFFFF) 


RETURN from 


J A 
EE EE EE EE pla ; "A RETURN from 


ASCII "phu" 


Figure 1.35: OllyDbg: f unsigned(): second conditional jump 


OllyDbg gives a hint that JNZ is to be triggered now. Indeed, JNZ triggering if ZF=0 
(zero flag). 
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The third conditional jump, JNB: 


CPU - main thread, module ex 


Jump is not taken 
1A1895 


JBE SHORT 9611669 

PUSH OFFSET 66103018 

CALL DWORD PTR DS: (<&MSUCR1G0. printf >] 
ADD ESP, 4 

MOV ECX,DWORD PTR SS: CARG. 1] 

CMP ECX, DWORD PTR SS:CARG.2] 

JNE SHORT _0B1A107F 

PUSH OFFSET 00143020 

CALL DWORD PTR DS: [<8MSUCR100.printf>] 
ADD ESP, 4 

MOV EDX, DWORD PTR SS: CARG. 1] 

CMP EDX, DWORD PTR SS: [ARG.2] 

JAE SHORT 0011095 


PUSH OFFSET 69193628 
CALL DWORD PTR DS: (<&MSUCR1GG. printf >] 


¿MIEDO 


3 


n 


8 3;n' 
HIU ANY 


mmmim mmmn rmi 


a1R3 
OO181885 


B 
B 
a 


RETURN from 


RETURN from ex. Gi 
ASCII ”pNY” 


Figure 1.36: OllyDbg: f unsigned(): third conditional jump 


In Intel manuals (12.1.4 on page 1282) we can see that JNB triggers if CF=0 (carry 
flag). That is not true in our case, so the third printf() will execute. 
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Now let's review the f signed() function, which works with signed values, in Olly- 
Dbg. Flags are set in the same way: C=1, P=1, A=1, Z=0, S=1, T=0, D=0, O=0. 
The first conditional jump JLE is to be triggered: 


CPU - main thread, module ex (Ol x! 
a ^ 


PUSH EBP 

MOU EBP,ESP 

MOU EAX, DWORD PTR SS: CARG. 1] 

CMP ERX,DWORD PTR SS: CARG.2] 

JLE SHORT 96181619 

68 00201000 | PUSH OFFSET 66193000 

FF15 Ba2oiBot em PTR DS: (<&MSUCR16@. printf >] 
MOU ECX,DWORD PTR SS: CARG. 1] 

CMP ECX, DWORD PTR SS:CARG.2] 

JNE SHORT 961A162F 

PUSH OFFSET 00143008 

CALL DWORD PTR DS: (<&MSUCR1G@. printf >] 
ADD ESP, 4 

MOV EDX,DWORD PTR SS: CARG. 1] 


mmmmmmmm 


"bit atFFFFFFFF) 
bit &tFFFFFFFF) 
bit B(FFFFFFFF) 
bit DLFFFFFFFF) 
bit PEFDDGGG( FFF) 
bit B(FFFFFFFF) 


)O- 4n DO00 


868868868 ERROR. SUCC 


aoe 
Y 


RETURN from ex. Bl 
ASCII "pnu” 


Gom 
) 0 Co Co (5 Tl 


c oaomtudoom 


Figure 1.37: OllyDbg: f signed(): first conditional jump 


In Intel manuals (12.1.4 on page 1282) we find that this instruction is triggered if 
ZF=1 or SF+OF. SF+OF in our case, so the jump triggers. 
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The second JNZ conditional jump triggering: if ZF=0 (zero flag): 


CPU - main thread, module ex 


PUSH EBP 

MOU EBP,ESP 

MOU EAX, DWORD PTR SS: [ARG. 1] 

CMP EAX, DWORD PTR SS: CARG.2] 

JLE SHORT 96101619 

PUSH OFFSET 00143000 

CALL DWORD PTR DS: (<&MSUCR1IGG. printf >] 


ADD ESP, 4 
MOU ECX, DWORD PTR SS: CARG.1] 
CMP EG, DWORD PTR 55: LARG: 23 
PUSH RETE Fc i E 
: : 9 jit B(FFFFFFFF) 
CALL DUORD PTR DS:LCBMSUCRIBD. print£? ; Me GLEFFFEEEF) 
8B55 08 MOU EDX; DWORD PTR SS: CARG.1] 
p A Da Li B R 


Mmmm mmm rm 


RETURN from ex. Bl 
ASCII "pNu" 


Figure 1.38: OllyDbg: f signed(): second conditional jump 
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The third conditional jump JGE will not trigger because it would only do so if SF=OF, 
and that is not true in our case: 


CPU - main thread, n  - [ni x| 


JLE SHORT 66181619 

PUSH OFFSET 00143000 

CALL DWORD PTR DS: L4&MSUCR188.printf?1 
RDD ESP,4 


NOU ECX, DWORD PTR $S:CARG. 1] 

CMP ECX, DWORD PTR SS: CARG.2] 

JNE SHORT _061A102F 

PUSH OFFSET 00143008 

CALL DWORD PTR DS: [<8MSUCR10B. printf >] 

ADD ESP, 4 

MOV EDX, DWORD PTR SS: CARG. 1] 

CMP EDX, DWORD PTR SS: [ARG. 2] 

JGE SHORT 061A1045 

68 10201000 [PUSH OFFSET Gainsaia [is 
FF15 Beene! CALL DWORD PTR DS: [<2MSUCR19B.printf>1 [Lis 


m Mmm mm mm mi 


Al 
Bt FFFFFFFF) 
@( FFFFFFFF) 

t @(FFFFFFFF) 
BtFFFFFFFF) 
TEFDDOBOLFFF) 

t @(FFFFFFFF) 


NDIO 


RETURN from ex. Bl 
ASCII "phu" 


) co 


Figure 1.39: OllyDbg: f signed(): third conditional jump 
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x86 + MSVC + Hiew 


We can try to patch the executable file in a way that the f unsigned() function 
would always print “a==b", no matter the input values. Here is how it looks in Hiew: 


Figure 1.40: Hiew: f unsigned() function 


Essentially, we have to accomplish three tasks: 
* force the first jump to always trigger; 
* force the second jump to never trigger; 
* force the third jump to always trigger. 


Thus we can direct the code flow to always pass through the second printf(), and 
output “a==b”. 


Three instructions (or bytes) has to be patched: 
* The first jump becomes JMP, but the jump offset would remain the same. 


* The second jump might be triggered sometimes, but in any case it will jump to 
the next instruction, because, we set the jump offset to O. 
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In these instructions the jump offset is added to the address for the next in- 
struction. So if the offset is 0, the jump will transfer the control to the next 
instruction. 


* The third jump we replace with JMP just as we do with the first one, so it will 
always trigger. 
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Here is the modified code: 


Figure 1.41: Hiew: let's modify the f unsigned() function 


If we miss to change any of these jumps, then several printf() calls may execute, 
while we want to execute only one. 


Non-optimizing GCC 


Non-optimizing GCC 4.4.1 produces almost the same code, but with puts() (1.5.3 
on page 28) instead of printf(). 


Optimizing GCC 


An observant reader may ask, why execute CMP several times, if the flags has the 
same values after each execution? 


Perhaps optimizing MSVC cannot do this, but optimizing GCC 4.8.1 can go deeper: 
Listing 1.113: GCC 4.8.1 f signea() 


f signed: 
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mov eax, DWORD PTR [esp+8] 
cmp DWORD PTR [esp+4], eax 
jg .L6 
je .L7 
jge .L1 
mov DWORD PTR [esp+4], OFFSET FLAT:.LC2 ; "a<b" 
jmp puts 
.L6: 
mov DWORD PTR [esp+4], OFFSET FLAT:.LCO ; "a>b" 
jmp puts 
.L1: 
rep ret 
.L7: 
mov DWORD PTR [esp+4], OFFSET FLAT:.LC1 ; "a==b" 
jmp puts 


We also see JMP puts here instead of CALL puts / RETN. 
This kind of trick will have explained later: 1.21.1 on page 197. 


This type of x86 code is somewhat rare. MSVC 2012 as it seems, can't generate 
such code. On the other hand, assembly language programmers are fully aware of 
the fact that Jcc instructions can be stacked. 


So if you see such stacking somewhere, it is highly probable that the code was hand- 
written. 


The f unsigned() function is not that aesthetically short: 


Listing 1.114: GCC 4.8.1 f unsigned() 


f unsigned: 
push esi 
push ebx 
sub esp, 20 
mov esi, DWORD PTR [esp+32] 
mov ebx, DWORD PTR [esp+36] 
cmp esi, ebx 
ja .L13 
cmp esi, ebx ; this instruction could be removed 
je .L14 
.L10: 
jb .L15 
add esp, 20 
pop ebx 
pop esi 
ret 
.L15: 
mov DWORD PTR [esp+32], OFFSET FLAT:.LC2 ; "a<b" 
add esp, 20 
pop ebx 
pop esi 
jmp puts 
.L13: 
mov DWORD PTR [esp], OFFSET FLAT:.LCO ; "a>b" 
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call puts 
cmp esi, ebx 
jne .L10 
.L14: 
mov DWORD PTR [esp+32], OFFSET FLAT:.LC1 ; "a==b" 
add esp, 20 
pop ebx 
pop esi 
jmp puts 


Nevertheless, there are two CMP instructions instead of three. 
So optimization algorithms of GCC 4.8.1 are probably not perfect yet. 


ARM 
32-bit ARM 


Optimizing Keil 6/2013 (ARM mode) 


Listing 1.115: Optimizing Keil 6/2013 (ARM mode) 


.text:000000B8 EXPORT f signed 

.text:000000B8 f signed ; CODE XREF: main+C 
.text:000000B8 70 40 2D E9 STMFD SP!, {R4-R6,LR} 
.text:000000BC 01 40 AO E1 MOV R4, R1 

.text:000000CO 04 00 50 E1 CMP RO, R4 

.text:000000C4 00 50 AO E1 MOV R5, RO 

.text:000000C8 1A OE 8F C2 ADRGT RO, aAB > “a>b\n" 
.text:000000CC A1 18 00 CB BLGT . 2printf 

.text:000000D0 04 00 55 El CMP R5, R4 

.text:000000D4 67 OF 8F 02 ADREQ RO, aAB 0 ; “a==b\n" 
. text: 000000D8 9E 18 00 OB BLEQ . 2printf 

.text:000000DC 04 00 55 E1 CMP R5, R4 

.text:000000E0 70 80 BD A8 LDMGEFD SP!, {R4-R6,PC} 

. text: 000000E4 70 40 BD E8 LDMFD SP!, {R4-R6,LR} 
.text:000000E8 19 OE 8F E2 ADR RO, aAB 1 > "a«bAn" 
.text:000000EC 99 18 00 EA B . 2printf 

.text:000000EC ; End of function f signed 


Many instructions in ARM mode could be executed only when specific flags are set. 
E.g. this is often used when comparing numbers. 


For instance, the ADD instruction is in fact named ADDAL internally, where AL stands 
for Always, i.e., execute always. The predicates are encoded in 4 high bits of the 
32-bit ARM instructions (condition field). The B instruction for unconditional jumping 
is in fact conditional and encoded just like any other conditional jump, but has AL in 
the condition field, and it implies execute ALways, ignoring flags. 
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The ADRGT instruction works just like ADR but executes only in case the previous CMP 
instruction founds one of the numbers greater than the another, while comparing 
the two (Greater Than). 


The next BLGT instruction behaves exactly as BL and is triggered only if the result of 
the comparison has been (Greater Than). ADRGT writes a pointer to the string a>b\n 
into RO and BLGT calls printf(). Therefore, instructions suffixed with -GT are to 
execute only in case the value in RO (which is a) is bigger than the value in R4 (which 
is b). 


Moving forward we see the ADREQ and BLEQ instructions. They behave just like ADR 
and BL, but are to be executed only if operands were equal to each other during 
the last comparison. Another CMP is located before them (because the printf() 
execution may have tampered the flags). 


Then we see LDMGEFD, this instruction works just like LDMFD??, but is triggered only 
when one of the values is greater or equal than the other (Greater or Equal). The 
LDMGEFD SP!, {R4-R6,PC} instruction acts like a function epilogue, but it will be 
triggered only if a >= b, and only then the function execution will finish. 


But if that condition is not satisfied, i.e., a « b, then the control flow will continue to 
the next 

"LDMFD SP!, {R4-R6,LR}” instruction, which is one more function epilogue. This 
instruction restores not only the R4-R6 registers state, but also LR instead of PC, 
thus, it does not return from the function. The last two instructions call printf() 
with the string «a<b\n» as a sole argument. We already examined an unconditional 
jump to the printf() function instead of function return in «printf() with several 
arguments» section (1.11.2 on page 71). 


f unsignedis similar, only the ADRHI, BLHI, and LDMCSFD instructions are used there, 
these predicates (H/ = Unsigned higher, CS = Carry Set (greater than or equal)) are 
analogous to those examined before, but for unsigned values. 


There is not much new in the main() function for us: 


Listing 1.116: main() 


.text:00000128 EXPORT main 
.text:00000128 main 

.text:00000128 10 40 2D E9 STMFD SP!, {R4,LR} 
.text:0000012C 02 10 AO E3 MOV R1, 42 
.text:00000130 01 00 AO E3 MOV RO, #1 
.text:00000134 DF FF FF EB BL f signed 
.text:00000138 02 10 AO E3 MOV R1, #2 
.text:0000013C 01 00 AO E3 MOV RO, #1 
.text:00000140 EA FF FF EB BL f unsigned 
.text:00000144 00 00 AO E3 MOV RO, #0 
.text:00000148 10 80 BD E8 LDMFD SP!, {R4,PC} 
.text:00000148 ; End of function main 


That is how you can get rid of conditional jumps in ARM mode. 


Why is this so good? Read here: 2.4.1 on page 575. 


921 DMFD 
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There is no such feature in x86, except the CMOVcc instruction, it is the same as MOV, 
but triggered only when specific flags are set, usually set by CMP. 


Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.117: Optimizing Keil 6/2013 (Thumb mode) 


.text:00000072 f signed ; CODE XREF: main+6 
.text:00000072 70 B5 PUSH {R4-R6,LR} 

. text: 00000074 0C 00 MOVS RA, R1 

.text:00000076 05 00 MOVS R5, RO 

.text:00000078 A0 42 CMP RO, R4 

.text:0000007A 02 DD BLE loc 82 

.text:0000007C A4 AO ADR RO, aAB ; “a>b\n" 
.text:0000007E 06 FO B7 F8 BL _ 2printf 

.text:00000082 

.text:00000082 loc 82 ; CODE XREF: f signed-8 
.text:00000082 A5 42 CMP R5, R4 

.text:00000084 02 D1 BNE loc 8C 

.text:00000086 A4 AO ADR RO, aAB 0 ; “a==b\n" 
.text:00000088 06 FO B2 F8 BL _ 2printf 

.text:0000008C 

.text:0000008C loc 8C ; CODE XREF: f _signed+12 
.text:0000008C A5 42 CMP R5, R4 

.text:0000008bE 02 DA BGE locret 96 

.text:00000090 A3 AO ADR RO, aAB 1 ; “a<b\n" 
.text:00000092 06 FO AD F8 BL _ 2printf 

.text:00000096 

.text:00000096 locret 96 ; CODE XREF: f _signed+1C 
.text:00000096 70 BD POP {R4-R6,PC} 

. text: 00000096 ; End of function f signed 


Only B instructions in Thumb mode may be supplemented by condition codes, so the 
Thumb code looks more ordinary. 


BLE is a normal conditional jump Less than or Equal, BNE—Not Equal, BGE—Greater 
than or Equal. 


f unsigned is similar, only other instructions are used while dealing with unsigned 
values: BLS (Unsigned lower or same) and BCS (Carry Set (Greater than or equal)). 


ARM64: Optimizing GCC (Linaro) 4.9 


Listing 1.118: f signed() 


f signed: 

; WO=a, Wl=b 
cmp wO, wl 
bgt .L19 ; Branch if Greater Than (a»b) 
beq .L20 ; Branch if Equal (a==b) 
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bge .L15 ; Branch if Greater than or Equal (a»-b) (impossible 
here) 

; a«b 

adrp x0, .LC11 ; "a«b" 

add x0, x0, :1012:.LC11 

b puts 
.L19: 

adrp x0, .LC9 ; "a»b" 

add x0, x0, :1012:.LC9 

b puts 
.L15: ; impossible to get here 

ret 
.L20: 

adrp x0, .LC10 ; "a--b" 

add x0, x0, :lo12:.LC10 

b puts 

Listing 1.119: f unsigned() 

f unsigned: 

stp x29, x30, [sp, -48]! 
; WO=a, Wl=b 

cmp wO, wl 

add x29, sp, 0 

str x19, [sp,16] 

mov w19, w0 

bhi .L25 ; Branch if HIgher (a»b) 

cmp w19, wl 

beq .L26 ; Branch if Equal (a==b) 
.L23: 

bcc . L27 ; Branch if Carry Clear (if less than) (a<b) 


; function epilogue, impossible to be here 


.L27: 


.L25: 


.L26: 


ldr x19, [sp,16] 
ldp x29, x30, [sp], 48 
ret 


ldr x19, [sp,16] 


adrp x0, .LC11 ; "a«b" 
ldp x29, x30, [sp], 48 

add x0, x0, :lo12:.LC11 

b puts 

adrp x0, .LC9 ; "a»b" 
str x1, [x29,40] 

add x0, x0, :lo12:.LC9 

bl puts 

ldr x1, [x29,40] 

cmp w19, wl 

bne .L23 ; Branch if Not Equal 
ldr x19, [sp,16] 

adrp x0, .LC10 ; "a--b" 
ldp x29, x30, [sp], 48 

add x0, x0, :lo12:.LC10 
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b puts 


The comments were added by the author of this book. What is striking is that the 
compiler is not aware that some conditions are not possible at all, so there is dead 
code at some places, which can never be executed. 


Exercise 


Try to optimize these functions manually for size, removing redundant instructions, 
without adding new ones. 


MIPS 


One distinctive MIPS feature is the absence of flags. Apparently, it was done to 
simplify the analysis of data dependencies. 


There are instructions similar to SETcc in x86: SLT ("Set on Less Than": signed 
version) and SLTU (unsigned version). These instructions sets destination register 
value to 1 if the condition is true or to 0 if otherwise. 


The destination register is then checked using BEQ ("Branch on Equal") or BNE ("Branch 
on Not Equal") and a jump may occur. So, this instruction pair has to be used in MIPS 
for comparison and branch. Let's first start with the signed version of our function: 


Listing 1.120: Non-optimizing GCC 4.4.5 (IDA) 


.text:00000000 f signed: # CODE XREF: main+18 
.text:00000000 


.text:00000000 var 10 - -0x10 
.text:00000000 var 8 = -8 
.text:00000000 var 4 = -4 
.text:00000000 arg 0 = 0 
.text:00000000 arg 4 = 4 
.text:00000000 

.text:00000000 addiu  $sp, -0x20 


. text : 00000004 SW $ra, 0x20+var_4($sp) 
.text:00000008 SW $fp, 0x20-var 8($sp) 
.text:0000000C move $fp, $sp 
.text:00000010 la $gp, gnu local gp 
.text:00000018 SW $gp, 0x20«var 10($sp) 
; store input values into local stack: 
.text:0000001C SW $a0, Ox20+arg 0($fp) 
. text: 00000020 Sw $al, 0x20+arg 4($fp) 
; reload them. 

.text:00000024 lw $v1, 0x20+arg_0($fp) 
. text: 00000028 lw $v0, Ox20+arg 4($fp) 
; $vO-b 

; $v1-a 

.text:0000002C or $at, $zero ; NOP 


; this is pseudoinstruction. in fact, "slt $v0,$v0O,$v1" is there. 
; so $v0 will be set to 1 if $vO«$v1 (b«a) or to 0 if otherwise: 
.text:00000030 slt $v0, $v1 
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; jump to loc 5c, if condition is not true. 


; this is pseudoinstruction. in fact, 


Zz $v@, loc 5C 
$at, $zero ; branch delay slot, NOP 
$v0, (unk 230 »» 16) £ "a»b" 

iu  $a0, $v0, (unk 230 € OxFFFF) # "a>b" 
$v0, (puts & OxFFFF) ($gp) 
$at, $zero ; NOP 

e $t9, $v0 

r $t9 
$at, $zero ; branch delay slot, NOP 
$gp, 0x20-var 10($fp) 

3 CODE XREF: f_signed+34 

$v1, 0x20+arg_0($fp) 
$v0, Ox20+arg 4($fp) 
$at, $zero ; NOP 


; check if a--b, jump to loc 90 if its not true: 


.text:00000034 beq 
; print "a>b" and finish 
.text:00000038 or 
.text:0000003C lui 
.text:00000040 add 
.text:00000044 lw 
.text:00000048 or 
.text:0000004C mov 
.text:00000050 jal 
. text: 00000054 or 
. text: 00000058 lw 
. text: 0000005C 
.text:0000005C loc 5C: 
.text:0000005C lw 
. text: 00000060 lw 
. text : 00000064 or 
. text: 00000068 bne 
. text: 0000006C or 
; condition is true, so pr 
. text: 00000070 lui 
. text: 00000074 add 
. text: 00000078 lw 
. text: 0000007C or 
. text : 00000080 mov 
. text: 00000084 jal 
. text: 00000088 or 
. text: 0000008C lw 
. text: 00000090 

. text: 00000090 loc 90: 

. text: 00000090 lw 
. text : 00000094 lw 
. text: 00000098 or 


; check if $vl<$v@ (a<b), 


. text: 0000009C 
; if condition 
.text:000000A0 
.text:000000A4 
; condition is 
.text:000000A8 
.text:000000AC 
.text:000000B0 
.text:000000B4 
.text:000000B8 
.text:000000BC 
. text: 000000C0 
. text: 000000C4 
. text: 000000C8 
; all 
. text :000000C8 
f signed+A0 
. text: 000000C8 


slt 
is not true 
beq 
or 
true, print 
lui 
add 
lw 
or 
mov 
jal 
or 
lw 


3 conditions were false, 


loc C8: 


mov 


$v1, $v0, loc 90 
$at, $zero ; branch delay slot, NOP 
int "a--b" and finish: 
$v0, (aAB >> 16) # "a==b" 
iu $a0, $v0, (aAB € OXFFFF) # 
$v0, (puts & OxFFFF) ($gp) 
$at, $zero ; NOP 
e $t9, $v0 
r $t9 
$at, 
$9p, 


"aq==p" 


$zero ; branch delay slot, NOP 
0x20+var_10($fp) 


# CODE XREF: f_signed+68 


$v1, 0x20+arg_0($fp) 
$v0, Ox20+arg 4($fp) 
$at, $zero ; NOP 
set $v0 to 1 if condition is true: 
$vO, $vl, $v0 
(i.e., $v0--0), jump to loc c8: 


Zz $v0, loc C8 
$at, $zero ; branch delay slot, NOP 
"a«b" and finish 
$v0, (aAB 0 >> 16) # "a<b" 
iu  $a0, $v0, (aAB 0 € OXFFFF) # "a<b" 
$v0, (puts & OxFFFF) ($gp) 
$at, $zero ; NOP 
e $t9, $v0 
r $t9 
$at, $zero ; branch delay slot, NOP 
$gp, 0x20+var_10($fp) 
so just finish: 
# CODE XREF: 
e $sp, $fp 


"beq $v0,$zero,loc_5c" is there: 
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.text:000000CC lw $ra, Ox20+var_4($sp) 

.text:000000D0 lw $fp, 0x20-var 8($sp) 

. text: 000000D4 addiu  $sp, 0x20 

.text:000000D8 jr $ra 

.text:000000DC or $at, $zero ; branch delay slot, NOP 


.text:000000DC # End of function f signed 


SLT REGO, REGO, REGI is reduced by IDA to its shorter form: 
SLT REGO, REGI. 


We also see there BEQZ pseudo instruction ("Branch if Equal to Zero"), 
which are in fact BEQ REG, $ZERO, LABEL 


The unsigned version is just the same, but SLTU (unsigned version, hence "U" in 
name) is used instead of SLT: 


Listing 1.121: Non-optimizing GCC 4.4.5 (IDA) 


.text:000000E0 f unsigned: # CODE XREF: main+28 
.text:000000E0 

.text:000000E0 var 10 = -0x10 

.text:000000E0 var 8 = -8 

.text:000000E0 var 4 = -4 

.text:000000E0 arg 0 = 0 

.text:000000E0 arg 4 = 4 

.text:000000E0 

.text:000000E0 addiu  $sp, -0x20 
.text:000000E4 SW $ra, 0x20+var_4($sp) 
. text: 000000E8 SW $fp, 0x20-var 8($sp) 
.text:000000EC move $fp, $sp 
.text:000000F0 la $gp, gnu local gp 
.text:000000F8 SW $gp, 0x20+var_10($sp) 
.text:000000FC SW $a0, Ox20+arg 0($fp) 
. text: 00000100 Sw $al, 0x20+arg_4($fp) 
.text:00000104 lw $v1, 0x20+arg_0($fp) 
.text:00000108 lw $v0, Ox20+arg 4($fp) 
. text: 0000010C or gat, $zero 

. text: 00000110 sltu $v0, $v1 
.text:00000114 begz $v0, loc 13C 
.text:00000118 or $at, $zero 
.text:0000011C lui $v0, (unk 230 >> 16) 
.text:00000120 addiu  $a0, $v0, (unk 230 € OxFFFF) 
.text:00000124 lw $v0, (puts € OxFFFF) ($gp) 
.text:00000128 or $at, $zero 
.text:0000012C move $t9, $v0 
.text:00000130 jalr $t9 

.text:00000134 or $at, $zero 
.text:00000138 lw $gp, 0x20+var_10($fp) 
.text:0000013C 

.text:0000013C loc 13C: # CODE XREF: f unsigned+34 
.text:0000013C lw $v1, 0x20+arg_0($fp) 
.text:00000140 lw $v0, Ox20+arg 4($fp) 
. text: 00000144 or gat, $zero 

. text: 00000148 bne $v1, $v0, loc 170 
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.text:0000014C or $at, $zero 

. text: 00000150 lui $v0, (aAB >> 16) # "a==b" 
.text:00000154 addiu $a0, $v0, (aAB € OXFFFF) # "a--b" 
.text:00000158 lw $v0, (puts € OxFFFF) ($gp) 
.text:0000015C or $at, $zero 

.text:00000160 move $t9, $v0 

.text:00000164 jalr $t9 

. text: 00000168 or $at, $zero 

. text : 0000016C lw $gp, 0x20+var_10($fp) 
.text:00000170 

.text:00000170 loc 170: # CODE XREF: f unsigned+68 
.text:00000170 lw $v1, 0x20-arg O($fp) 
.text:00000174 lw $v0, Ox20+arg 4($fp) 

. text: 00000178 or gat, $zero 

. text: 0000017C sltu $v0, $v1, $v0 

.text:00000180 begz $v0, loc 1A8 

.text:00000184 or $at, $zero 

.text:00000188 lui $v0, (aAB 0 >> 16) # "a<b" 
.text:0000018C addiu $a0, $v0, (aAB 0 € OxFFFF) £ “a<b" 
.text:00000190 lw $v0, (puts € OxFFFF) ($gp) 
.text:00000194 or $at, $zero 

.text:00000198 move $t9, $v0 

. text: 0000019C jalr $t9 

.text:000001A0 or $at, $zero 

.text:000001A4 lw $gp, 0x20-var 10($fp) 
.text:000001A8 

.text:000001A8 loc 1A8: # CODE XREF: f unsigned+A0 
.text:000001A8 move $sp, $fp 

.text:000001AC lw $ra, 0x20-var 4($sp) 
.text:000001B0 lw $fp, 0x20-var 8($sp) 
.text:000001B4 addiu  $sp, 0x20 

.text:000001B8 jr $ra 

.text:000001BC or $at, $zero 


.text:000001BC # End of function f 


unsigned 


1.18.2 Calculating absolute value 


A simple function: 


int my abs (int i) 
1 
if (i«0) 
return -i; 
else 
return i; 


yi 


Optimizing MSVC 


This is how the code is usually generated: 
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Listing 1.122: Optimizing MSVC 2012 x64 


i$28 
my abs PROC 
; ECX = input 
test ecx, ecx 
; check for sign of input value 
; Skip NEG instruction if sign is positive 


jns SHORT $LN2QGmy abs 
; negate value 
neg ecx 


$LN2Gmy abs: 
; prepare result in EAX: 


mov eax, ecx 
ret 0 
my abs ENDP 


GCC 4.9 does mostly the same. 


Optimizing Keil 6/2013: Thumb mode 


Listing 1.123: Optimizing Keil 6/2013: Thumb mode 


my abs PROC 

CMP r0,#0 
; is input value equal to zero or greater than zero? 
; skip RSBS instruction then 


BGE |LO.6| 
; subtract input value from 0: 
RSBS r0,r0,#0 
|LO.6| 
lr 
ENDP 


ARM lacks a negate instruction, so the Keil compiler uses the “Reverse Subtract" 
instruction, which just subtracts with reversed operands. 
Optimizing Keil 6/2013: ARM mode 


It is possible to add condition codes to some instructions in ARM mode, so that is 
what the Keil compiler does: 


Listing 1.124: Optimizing Keil 6/2013: ARM mode 


my abs PROC 
CMP r0,#0 
; execute "Reverse Subtract" instruction 
; only if input value is less than 0: 
RSBLT r0, r0,#0 
BX lr 
ENDP 


Now there are no conditional jumps and this is good: 2.4.1 on page 575. 
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Non-optimizing GCC 4.9 (ARM64) 
ARM64 has instruction NEG for negating: 
Listing 1.125: Optimizing GCC 4.9 (ARM64) 


my abs: 

sub sp, sp, £16 

str w0, [sp,12] 

ldr w0, [sp,12] 
; compare input value with contents of WZR register 
; (which always holds zero) 


cmp w0, wzr 
bge .L2 
ldr w0, [sp,12] 
neg w0, wO 
b .L3 
.L2: 
ldr w0, [sp,12] 
.L3: 
add sp, sp, 16 
ret 
MIPS 
Listing 1.126: Optimizing GCC 4.4.5 (IDA) 
my abs: 


; jump if $a0«0: 
bltz $a0, locret 10 
; just return input value ($a0) in $v0: 


move $v0, $a0 

jr $ra 

or $at, $zero ; branch delay slot, NOP 
locret_10: 
; negate input value and store it in $v0: 

jr $ra 
; this is pseudoinstruction. in fact, this is "subu $v0,$zero,$aQ" 

($vQ=0- $a0) 


negu $v0, $a 


Here we see a new instruction: BLTZ (“Branch if Less Than Zero”). 


There is also the NEGU pseudo instruction, which just does subtraction from zero. 
The "U" suffix in both SUBU and NEGU implies that no exception to be raised in case 
of integer overflow. 


Branchless version? 


You could have also a branchless version of this code. This we will review later: 3.16 
on page 648. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


180 


1.18.3 Ternary conditional operator 


The ternary conditional operator in C/C++ has the following syntax: 


expression ? expression : expression 


Here is an example: 


const char* f (int a) 


1 
yi 


return a==10 ? "it is ten" : "it is not ten"; 


x86 


Old and non-optimizing compilers generate assembly code just as if an if/else 
statement was used: 


Listing 1.127: Non-optimizing MSVC 2008 


$SG746 DB ‘it is ten', OOH 
$5G747 DB ‘it is not ten', OOH 
tv65 = -4 ; this will be used as a temporary variable 
_ag = 8 
_f PROC 
push ebp 
mov ebp, esp 
push ecx 
; compare input value with 10 
cmp DWORD PTR a$[ebp], 10 
; jump to $LN3@f if not equal 
jne SHORT $LN3@f 
; Store pointer to the string into temporary variable: 
mov DWORD PTR tv65[ebp], OFFSET $SG746 ; ‘it is ten' 
; jump to exit 
jmp SHORT $LN4@f 
$LN3@fF : 
; Store pointer to the string into temporary variable: 
mov DWORD PTR tv65[ebp], OFFSET $SG747 ; ‘it is not ten' 
$LNAQf : 


; this is exit. 
; copy pointer to the string from temporary variable to EAX. 


mov eax, DWORD PTR tv65[ebp] 
mov esp, ebp 
pop ebp 
ret 0 
f ENDP 


Listing 1.128: Optimizing MSVC 2008 


$SG792 DB ‘it is ten', OOH 
$SG793 DB ‘it is not ten', OOH 
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8 ; size = 4 
PROC 
; compare input value with 10 
cmp DWORD PTR a$[esp-4], 10 
mov eax, OFFSET $SG792 ; ‘it is ten' 
; jump to $LN4@f if equal 


je SHORT $LN4@f 

mov eax, OFFSET $5G793 ; ‘it is not ten' 
$LNAQf : 

ret 0 
f ENDP 


Newer compilers are more concise: 


Listing 1.129: Optimizing MSVC 2012 x64 


$5G1355 DB ‘it is ten', OOH 
$5G1356 DB 'it is not ten', 00H 
a$ = 8 

f PROC 


; load pointers to the both strings 
lea rdx, OFFSET FLAT:$SG1355 ; 
lea rax, OFFSET FLAT:$SG1356 ; 
; compare input value with 10 
cmp ecx, 10 
; if equal, copy value from RDX ("it is ten") 
; if not, do nothing. pointer to the string 
; "it is not ten" is still in RAX as for now. 


'it is ten' 
'it is not ten' 


cmove rax, rdx 
ret 0 
f ENDP 


Optimizing GCC 4.8 for x86 also uses the CMOVcc instruction, while the non-optimizing 
GCC 4.8 uses conditional jumps. 


ARM 
Optimizing Keil for ARM mode also uses the conditional instructions ADRcc: 


Listing 1.130: Optimizing Keil 6/2013 (ARM mode) 


f PROC 
; compare input value with 10 
CMP r0,#0xa 
; if comparison result is EQual, copy pointer to the "it is ten" string into 
ADREQ ro,|L0.16| ; "it is ten" 
; if comparison result is Not Equal, copy pointer to the 
; "it is not ten" string into RO 
ADRNE r0, |L0.28| ; "it is not ten" 
BX lr 
ENDP 
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[L0.16| 

DCB "it is ten",0 
[L0.28| 

DCB "it is not ten",0 


Without manual intervention, the two instructions ADREQ and ADRNE cannot be exe- 
cuted in the same run. 


Optimizing Keil for Thumb mode needs to use conditional jump instructions, since 
there are no load instructions that support conditional flags: 


Listing 1.131: Optimizing Keil 6/2013 (Thumb mode) 


f PROC 
; compare input value with 10 
CMP r0,#0xa 
; jump to |LO.8| if EQual 
BEQ [L0.8| 
ADR r0,|L0.12| ; "it is not ten" 
BX lr 
[L0.8| 
ADR r0,|L0.28| ; "it is ten" 
BX lr 
ENDP 
[L0.12| 
DCB "it is not ten",0 
[L0.28| 
DCB "it is ten",0 
ARM64 


Optimizing GCC (Linaro) 4.9 for ARM64 also uses conditional jumps: 
Listing 1.132: Optimizing GCC (Linaro) 4.9 


f: 
cmp x0, 10 
beq .L3 ; branch if equal 
adrp x0, .LC1 ; "it is ten" 
add x0, x0, :lo12:.LC1 
ret 
.L3: 
adrp x0, .LCO ; "it is not ten" 
add x0, x0, :1012:.LCO 
ret 
.LC0: 
.string "it is ten" 
.LC1: 


.string "it is not ten" 
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That is because ARM64 does not have a simple load instruction with conditional flags, 
like ADRcc in 32-bit ARM mode or CMOVcc in x86. 


It has, however, "Conditional SELect" instruction (CSEL)[ARM Architecture Reference 
Manual, ARMv8, for ARMv8-A architecture profile, (2013)p390, C5.5], but GCC 4.9 
does not seem to be smart enough to use it in such piece of code. 


MIPS 
Unfortunately, GCC 4.4.5 for MIPS is not very smart, either: 
Listing 1.133: Optimizing GCC 4.4.5 (assembly output) 


$LCO: 
.ascii “it is not ten\000" 
$LC1: 
.ascii “it is ten\000" 
f: 
li $2,10 # Oxa 
; compare $a0 and 10, jump if equal: 
beq $4,$2,$L2 


nop ; branch delay slot 


; leave address of "it is not ten" string in $v0 and return: 


lui $2,?shi($LCO) 
j $31 
addiu $2,$2,%lo($LCO) 
$L2: 
; leave address of "it is ten" string in $v0 and return: 
lui $2,%hi($LC1) 
j $31 


addiu $2, $2, %lo($LC1) 


Let’s rewrite it in an if/else way 


const char* f (int a) 


{ 
if (a==10) 
return "it is ten"; 
else 
return "it is not ten"; 
ur 


Interestingly, optimizing GCC 4.8 for x86 was also able to use CMOVcc in this case: 


Listing 1.134: Optimizing GCC 4.8 


.LC0: 

.string "it is ten" 
.LC1: 

.string "it is not ten" 
f: 
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. LFBO: 

; compare input value with 10 
cmp DWORD PTR [esp+4], 10 
mov edx, OFFSET FLAT:.LC1 ; "it is not ten" 
mov eax, OFFSET FLAT:.LCO ; "it is ten" 


; if comparison result is Not Equal, copy EDX value to EAX 
; if not, do nothing 

cmovne eax, edx 

ret 


Optimizing Keil in ARM mode generates code identical to listing.1.130. 
But the optimizing MSVC 2012 is not that good (yet). 


Conclusion 
Why optimizing compilers try to get rid of conditional jumps? Read here about it: 


2.4.1 on page 575. 


1.18.4 Getting minimal and maximal values 


32-bit 
int my max(int a, int b) 
{ 
if (a>b) 
return a; 
else 
return b; 
}; 
int my_min(int a, int b) 
{ 
if (a<b) 
return a; 
else 
return b; 
}; 
Listing 1.135: Non-optimizing MSVC 2013 
_ag = 8 
_b$ = 12 
_my_min PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
; compare A and B: 
cmp eax, DWORD PTR b$[ebp] 
; jump, if A is greater or equal to B: 
jge SHORT $LN2@my_min 


; reload A to EAX if otherwise and jump to exit 
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mov eax, DWORD PTR _a$[ebp] 
jmp SHORT $LN3@my min 
jmp SHORT $LN3@my_min ; this is redundant JMP 
$LN2Qmy min: 
; return B 
mov eax, DWORD PTR _b$[ebp] 
$LN3@my_min: 
pop ebp 
ret 0 
_my_min ENDP 
_a$ = 8 
_b$ = 12 
_my_max PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
; compare A and B: 
cmp eax, DWORD PTR _b$[ebp] 
; jump if A is less or equal to B: 
jle SHORT $LN2@my_max 
; reload A to EAX if otherwise and jump to exit 
mov eax, DWORD PTR _a$[ebp] 
jmp SHORT $LN3@my_max 
jmp SHORT $LN3@my_max ; this is redundant JMP 
$LN2GQGmy max: 
; return B 
mov eax, DWORD PTR b$[ebp] 
$LN3Gmy max: 
pop ebp 
ret 0 
my max ENDP 


These two functions differ only in the conditional jump instruction: JGE ("Jump if 
Greater or Equal") is used in the first one and JLE ("Jump if Less or Equal") in the 
second. 


There is one unneeded JMP instruction in each function, which MSVC presumably left 
by mistake. 


Branchless 


ARM for Thumb mode reminds us of x86 code: 


Listing 1.136: Optimizing Keil 6/2013 (Thumb mode) 


my max PROC 

; RO=A 

; R1=B 

; compare A and B: 
CMP ro, rl 

; branch if A is greater then B: 
BGT [L0.6| 
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; otherwise (A«-B) return R1 (B): 


MOVS r0,r1 
|LO.6| 
; return 
BX lr 
ENDP 
my min PROC 
; RO=A 
; R1=B 
; compare A and B: 
CMP r0,r1 
; branch if A is less then B: 
BLT [L0.14| 
; otherwise (A>=B) return R1 (B): 
MOVS r0,r1 
[L0.14| 
; return 
BX lr 
ENDP 


The functions differ in the branching instruction: BGT and BLT. It's possible to use 
conditional suffixes in ARM mode, so the code is shorter. 


MOVcc is to be executed only if the condition is met: 


Listing 1.137: Optimizing Keil 6/2013 (ARM mode) 


my max PROC 
; RO=A 
; R1=B 
compare A and B: 

CMP r0,r1 
; return B instead of A by placing B in RO 
; this instruction will trigger only if A<=B (hence, LE - Less or Equal) 
; if instruction is not triggered (in case of A>B), 
; A is still in RO register 

MOVLE r0,r1 


BX lr 
ENDP 

my min PROC 

; RO=A 

; R1=B 

; compare A and B: 
CMP r0,r1 


; return B instead of A by placing B in RO 
; this instruction will trigger only if A>=B (hence, GE - Greater or Equal) 
; if instruction is not triggered (in case of A<B), 
; A value is still in RO register 
MOVGE r0,r1 
BX lr 
ENDP 
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Optimizing GCC 4.8.1 and optimizing MSVC 2013 can use CMOVcc instruction, which 
is analogous to MOVcc in ARM: 


Listing 1.138: Optimizing MSVC 2013 


my max: 
mov edx, DWORD PTR [esp+4] 
mov eax, DWORD PTR [esp+8] 
; EDX=A 
; EAX=B 
; compare A and B: 
cmp edx, eax 


; if A>=B, load A value into EAX 
; the instruction idle if otherwise (if A<B) 
cmovge eax, edx 


ret 
my min: 
mov edx, DWORD PTR [esp+4] 
mov eax, DWORD PTR [esp+8] 
; EDX=A 
; EAX=B 
; compare A and B: 
cmp edx, eax 


; if A<=B, load A value into EAX 

; the instruction idle if otherwise (if A>B) 
cmovle eax, edx 
ret 


64-bit 


#include <stdint.h> 


int64 t my max(int64 t a, int64 t b) 


1 
if (a»b) 
return a; 
else 
return b; 
yi 
int64 t my min(int64 t a, int64 t b) 
1 
if (a«b) 
return a; 
else 
return b; 


There is some unneeded value shuffling, but the code is comprehensible: 


Listing 1.139: Non-optimizing GCC 4.9.1 ARM64 
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my max: 
sub sp, sp, #16 
str x0, [sp,8] 
str x1, [sp] 
ldr X1, [sp,8] 
ldr x0, [sp] 
cmp x1, x0 
ble .L2 
ldr x0, [sp,8] 
b .L3 
L2: 
ldr x0, [sp] 
.L3: 
add sp, sp, 16 
ret 
my min: 
sub sp, sp, #16 
str x0, [sp,8] 
str x1, [sp] 
ldr X1, [sp,8] 
ldr x0, [sp] 
cmp x1, x0 
bge .L5 
ldr x0, [sp,8] 
b .L6 
.L54 
ldr x0, [sp] 
.L6: 
add sp, sp, 16 
ret 
Branchless 


No need to load function arguments from the stack, as they are already in the regis- 


ters: 
Listing 1.140: Optimizing GCC 4.9.1 x64 

my max: 
; RDI-A 
; RSI-B 
; compare A and B: 

cmp rdi, rsi 
; prepare B in RAX for return: 

mov rax, rsi 


if A>=B, put A (RDI) in RAX for return. 

this instruction is idle if otherwise (if A«B), and B is left in RAX 
cmovge rax, rdi 
ret 


my min: 
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; RDI-A 

; RSI-B 

; compare A and B: 
cmp rdi, rsi 

; prepare B in RAX for return: 
mov rax, rsi 


; if A<=B, put A (RDI) in RAX for return. 

; this instruction is idle if otherwise (if A>B), and B is left in RAX 
cmovle rax, rdi 
ret 


MSVC 2013 does almost the same. 


ARM64 has the CSEL instruction, which works just as MOVcc in ARM or CMOVcc in x86, 
just the name is different: "Conditional SELect”. 


Listing 1.141: Optimizing GCC 4.9.1 ARM64 


my max: 
; XO=A 
; X1=B 
; compare A and B: 
cmp x0, x1 
; select X0 (A) to X0 if X0>=X1 or A>=B (Greater or Equal) 
; select X1 (B) to XO if A<B 


csel x0, x0, x1, ge 
ret 

my min: 

; X0-A 

; X1=B 

; compare A and B: 
cmp x0, x1 


select X0 (A) to X0 if X0<=X1 or A«-B (Less or Equal) 
select X1 (B) to XO if A>B 

csel x0, x0, x1, le 

ret 


MIPS 
Unfortunately, GCC 4.4.5 for MIPS is not that good: 
Listing 1.142: Optimizing GCC 4.4.5 (IDA) 


my max: 

; set $v1 to 1 if $al«$a0, or clear otherwise (if $al>$a0): 
slt $v1, $al, $a0 

; jump, if $v1 is 0 (or $al>$a0): 
beqz $v1, locret 10 

; this is branch delay slot 

; prepare $al in $v0 in case of branch triggered: 


move $v0, $al 
; no branch triggered, prepare $a0 in $v0: 
move $v0, $a0 
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locret 10: 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


; the min() function is same, but input operands 
; in SLT instruction are swapped: 


my min: 
slt $v1, $a0, $al 
beqz $v1, locret 28 
move $v0, $al 
move $v0, $a0 
locret_28: 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


Do not forget about the branch delay slots: the first MOVE is executed before BEQZ, 
the second MOVE is executed only if the branch hasn't been taken. 


1.18.5 Conclusion 
x86 


Here's the rough skeleton of a conditional jump: 


Listing 1.143: x86 


CMP register, register/value 

Jcc true ; cc=condition code 

false: 

;... some code to be executed if comparison result is false ... 
JMP exit 

true: 

;... some code to be executed if comparison result is true ... 
exit: 


ARM 


Listing 1.144: ARM 


CMP register, register/value 

Bcc true ; cc=condition code 

false: 

;... some code to be executed if comparison result is false ... 
JMP exit 

true: 

;... some code to be executed if comparison result is true ... 
exit: 
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MIPS 


Listing 1.145: Check for zero 


BEQZ REG, label 


Listing 1.146: Check for less than zero using pseudoinstruction 


BLTZ REG, label 


Listing 1.147: Check for equal values 


BEQ REG1, REG2, label 


Listing 1.148: Check for non-equal values 


BNE REG1, REG2, label 


Listing 1.149: Check for less than (signed) 


SLT REG1, REG2, REG3 
BEQ REG1, label 


Listing 1.150: Check for less than (unsigned) 


SLTU REG1, REG2, REG3 
BEQ REG1, label 


Branchless 


If the body of a condition statement is very short, the conditional move instruction 
can be used: MOVcc in ARM (in ARM mode), CSEL in ARM64, CMOVcc in x86. 


ARM 


It’s possible to use conditional suffixes in ARM mode for some instructions: 


Listing 1.151: ARM (ARM mode) 


CMP register, register/value 
instrl cc ; some instruction will be executed if condition code is true 
instr2 cc ; some other instruction will be executed if other condition code 


is true 
fua. “EUG. a's 
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Of course, there is no limit for the number of instructions with conditional code suf- 
fixes, as long as the CPU flags are not modified by any of them. 


Thumb mode has the IT instruction, allowing to add conditional suffixes to the next 
four instructions. Read more about it: 1.25.7 on page 324. 


Listing 1.152: ARM (Thumb mode) 


CMP register, register/value 

ITEEE EQ ; set these suffixes: if-then-else-else-else 

instrl ; instruction will be executed if condition is true 
instr2 ; instruction will be executed if condition is false 
instr3 ; instruction will be executed if condition is false 
instr4 ; instruction will be executed if condition is false 


1.18.6 Exercise 


(ARM64) Try rewriting the code in listing.1.132 by removing all conditional jump in- 
structions and using the CSEL instruction. 


1.19 Software cracking 


The vast majority of software can be cracked like that — by searching the very place 
where protection is checked, a dongle (8.8 on page 1055), license key, serial number, 
etc. 


Often, it looks like: 


call check protection 

jz all OK 

call message box protection missing 
call exit 

all OK: 

; proceed 


So if you see a patch (or "crack"), that cracks a software, and that patch replaces 
0x74/0x75 (JZ/JNZ) byte(s) by OxEB (JMP), this is it. 


The process of software cracking comes down to a search of that JMP. 


There are also a cases, when a software checks protection from time to time, this 
can be a dongle, or a license server can be queried through the Internet. Then you 
have to look for a function that checks protection. Then to patch it, to put there xor 
eax, eax / retn,ormov eax, 1 / retn. 


It's important to understand that after patching of function beginning, usually, a 
garbage follows these two instructions. The garbage consists of part of one instruc- 
tion and the several next instructions. 
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This is a real case. The beginning of a function which we want to replace by return 
1; 


Listing 1.153: Before 


8BFF mov edi,edi 

55 push ebp 

8BEC mov ebp,esp 
81EC68080000 sub esp, 000000868 
A110C00001 mov eax, [00100C010] 
33C5 xor eax,ebp 

8945FC mov [ebp][-4],eax 
53 push ebx 


8B5D08 mov ebx, [ebp][8] 


Listing 1.154: After 


B801000000 mov eax,1 

C3 retn 

EC in al,dx 
68080000A1 push 0A1000008 
10C0 adc al,al 

0001 add [ecx],al 

33C5 xor eax,ebp 
8945FC mov [ebp][-4],eax 
53 push ebx 


8B5D08 mov ebx, [ebp] [8] 


Several incorrect instructions appears — IN, PUSH, ADC, ADD, after which, Hiew dis- 
assembler (which | just used) synchronized and continued to disassemble all the 
rest. 


This is not important — all these instructions followed RETN will never be executed, 
unless a direct jump would occur from some place, and that wouldn’t be possible in 
general case. 


Also, a global boolean variable can be present, having a flag, was the software reg- 
istered or not. 


init etc proc 


call check protection or license file 
mov is demo, eax 


retn 
init_etc endp 


save file proc 
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mov eax, is demo 
cmp eax, 1 
jz alt 0K1 


call message box it is a demo no saving allowed 
retn 


:all OK1 
; continue saving file 


save proc endp 

somewhere else proc 

mov eax, is demo 

cmp eax, 1 

jz all OK 

; check if we run for 15 minutes 
; exit if it is so 


; or show nagging screen 


:all OK2 
; continue 


somewhere else endp 


A beginning ofthe check protection or license file() function could be patched, 
so that it will always return 1, or, if this is better by some reason, all JZ/JNZ instruc- 
tions can be patched as well. 


More about patching: 11.2. 


1.20 Impossible shutdown practical joke (Windows 
7) 


| don't quite remember how | found the ExitWindowsEx() function in Windows 98's 
(it was late 1990s) user32.dll file. Probably, | just spotted its self-describing name. 
And then I tried to block it by patching its beginning by OxC3 byte (RETN). 


The result was funny: Windows 98 cannot be shutted down anymore. Had to press 
reset button. 


These days I tried to do the same in Windows 7, that was created almost 10 years 
later and based on completely different Windows NT base. Still, ExitWindowsEx() 
function present in user32.dll file and serves the same purpose. 


First, | turned off Windows File Protection by adding this to registry (Windows would 
silently restore modified system files otherwise): 
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Windows Registry Editor Version 5.00 


[HKEY LOCAL MACHINENSOFTWAREMMicrosoftNWindows NT\CurrentVersion\Winlogon] 
"SFCDisable"-dword:ffffff9d 


Then | renamed c: NwindowsNsystem32Nuser32.dll to user32.dll.bak. | found 
ExitWindowsEx() export entry using Hiew (IDA can help as well) and put 0xC3 byte 
here. | restarted by Windows 7 and now it can't be shutted down. "Restart" and 
"Logoff" buttons don't work anymore. 


| don't know if it's funny today or not, but back then, in late 1990s, my friend took 
patched user32.dll file on a floppy diskette and copied it to all the computers (within 
his reach, that worked under Windows 98 (almost all)) at his university. No Windows 
can be shutted down after and his computer science teacher was lurid. (Hopefully 
he can forgive us if he is reading this right now.) 


If you do this, backup everything. The best idea is to run Windows under a virtual 
machine. 


1.21 switch()/case/default 


1.21.1 Small number of cases 


#include <stdio.h> 


void f (int a) 


{ 
switch (a) 
{ 
case 0: printf ("zero\n"); break; 
case 1: printf ("one\n"); break; 
case 2: printf ("two\n"); break; 
default: printf ("Something unknown\n"); break; 
}; 

}; 

int main() 

{ 
f (2); // test 

}; 

x86 


Non-optimizing MSVC 


Result (MSVC 2010): 
Listing 1.155: MSVC 2010 
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tv64 = -4 ; size = 4 
_ag = 8 ; size = 4 
f PROC 
push ebp 
mov ebp, esp 
push ecx 


mov eax, DWORD PTR a$[ebp] 
mov DWORD PTR tv64[ebp], eax 
cmp DWORD PTR tv64[ebp], 0 


je SHORT $LN4@f 
cmp DWORD PTR tv64[ebp], 1 
je SHORT $LN3@f 
cmp DWORD PTR tv64[ebp], 2 
je SHORT $LN2@f 
jmp SHORT $LN1@f 

$LN40f 


push OFFSET $5G739 ; 'zero', 0aH, 00H 
call printf 

add esp, 4 

jmp SHORT $LN7@f 


push OFFSET $SG741 ; 'one', 0aH, 00H 
call printf 

add esp, 4 

jmp SHORT $LN7@f 


push OFFSET $SG743 ; 'two', 0aH, 00H 
call printf 

add esp, 4 

jmp SHORT $LN7Gf 


push OFFSET $SG745 ; ‘something unknown', OaH, 00H 
call printf 
add esp, 4 


$LN7Gf 
mov esp, ebp 
pop ebp 
ret 0 

f ENDP 


Our function with a few cases in switch() is in fact analogous to this construction: 


void f (int a) 
1 
if (a==0) 
printf ("zero\n"); 
else if (a==1) 
printf ("one\n"); 
else if (a==2) 
printf ("two\n"); 
else 
printf ("something unknown\n") ; 


F; 
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If we work with switch() with a few cases it is impossible to be sure if it was a real 
switch() in the source code, or just a pack of if() statements. 


This implies that switch() is like syntactic sugar for a large number of nested if()s. 


There is nothing especially new to us in the generated code, with the exception of 
the compiler moving input variable a to a temporary local variable tv64 °°. 


If we compile this in GCC 4.4.1, we'll get almost the same result, even with maximal 
optimization turned on (-03 option). 


Optimizing MSVC 


Now let's turn on optimization in MSVC (/0x): cl 1.c /Fal.asm /0x 
Listing 1.156: MSVC 


a$ = 8 ; size = 4 


_f PROC 
mov eax, DWORD PTR a$[esp-4] 
sub eax, 0 
je SHORT $LN4@f 
sub eax, 1 
je SHORT $LN3@f 
sub eax, 1 
je SHORT $LN2@f 
mov DWORD PTR a$[esp-4], OFFSET $5G791 ; ‘something unknown', O0aH, 
"m | printf 
$LN2@f : 
mov DWORD PTR a$[esp-4], OFFSET $5G789 ; 'two', O0aH, 00H 
jmp | printf 
$LN30f : 
mov DWORD PTR a$[esp-4], OFFSET $SG787 ; 'one', 0aH, 00H 
jmp | printf 
$LN4@f : 
mov DWORD PTR a$[esp-4], OFFSET $5G785 ; 'zero', 0aH, 00H 
jmp | printf 
f ENDP 


Here we can see some dirty hacks. 


First: the value of a is placed in EAX and O is subtracted from it. Sounds absurd, 
but it is done to check if the value in EAX is 0. If yes, the ZF flag is to be set (e.g. 
subtracting from 0 is 0) and the first conditional jump JE (Jump if Equal or synonym 
JZ —Jump if Zero) is to be triggered and control flow is to be passed to the $LN4@f 
label, where the 'zero' message is being printed. If the first jump doesn't get 
triggered, 1 is subtracted from the input value and if at some stage the result is O, 
the corresponding jump is to be triggered. 


And if no jump gets triggered at all, the control flow passes to printf() with string 
argument 


93Local variables in stack are prefixed with tv—that's how MSVC names internal variables for its needs 
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'something unknown'. 


Second: we see something unusual for us: a string pointer is placed into the a vari- 
able, and then printf() is called not via CALL, but via JMP. There is a simple expla- 
nation for that: the caller pushes a value to the stack and calls our function via CALL. 
CALL itself pushes the return address (RA) to the stack and does an unconditional 
jump to our function address. Our function at any point of execution (since it do not 
contain any instruction that moves the stack pointer) has the following stack layout: 


* ESP— points to RA 
* ESP+4—points to the a variable 


On the other side, when we have to call printf() here we need exactly the same 
stack layout, except for the first printf() argument, which needs to point to the 
string. And that is what our code does. 


It replaces the function's first argument with the address of the string and jumps 
to printf(), as if we didn't call our function f(), but directly printf(). printf() 
prints a string to stdout and then executes the RET instruction, which POPs RA from 
the stack and control flow is returned not to f() but rather to f ()'s caller, bypassing 
the end of the f() function. 


All this is possible because printf () is called right at the end of the f () function in 
all cases. In some way, it is similar to the Longjmp( )?^ function. And of course, it is 
all done for the sake of speed. 


A similar case with the ARM compiler is described in “printf() with several arguments" 
section, here (1.11.2 on page 71). 


9^wikipedia 
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OllyDbg 


Since this example is tricky, let's trace it in OllyDbg. 


OllyDbg can detect such switch() constructs, and it can add some useful comments. 
EAX is 2 at the beginning, that's the function's input value: 


CPU - main thread, module few 
5 8B4424 04 liam EAX, DWORD PTR SS: CARG. 1] 


83E8 00 Ul : 
[e 30 Je SHORT OOFF1039 


E 
74 1F Je SHORT G0FF102B 
43 DEC EAX 
74 GE Je SHORT ØØFF1010 
C74424 94 MOU DWORD PTR SS: .11, "something unknowi 


"two", case 2 of 


.BOFF1804 


B(FFFFFFFF) 
D(FFFFFFFF) 
BtFFFFFFFF) 
BtFFFFFFFF) 
7EFDD@GG( FFF) 
OCFFFFFFFF) 


IP Garrinn4 
"one", case 1 of a E 


ci 
SS: LARG. 11, OFFSET GOFF300 "zero", case 8 of 
DS: L[X&HSUCR1868. printf >] 


4 Du 


RETURN from f 


ASCII "pre" 


8 — 4TuFiraKil 
H(* hN# 


Figure 1.42: OllyDbg: EAX now contain the first (and only) function argument 
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O is subtracted from 2 in EAX. Of course, EAX still contains 2. But the ZF flag is now 


0, indicating that the resulting value is non-zero: 


CPU - main thread, module few 


8B4424 04 MOV EAX, DWORD PTR SS:CARG.1] 
S3ES 00 Switch (cases 8..2, 4 e 
oe 


EC 

74 1F Je SHORT BO9FF102B 
48 DEC ERX 

74 GE Je SHORT @@FF161D 
C74424 04 MOY DWORD PTR SS:CARG.1],OFFSET 00FF361; ASCII "something unknown 
FF25 JMP DWORD PTR DS: [<2MSUCR100.printf>] 

MOY DWORD PTR SS: C[ARG.11,OFFSET 00FF3611 ASCII "two", case 2 of 
JMP DWORD PTR DS: [<2MSUCR100.printf>] 
MOY DWORD PTR SS: C[ARG.11,OFFSET 00FF300; ASCII "oneB", case 1 of 


la few. 
> BOFF1007 f 


D AnD 


JMP DWORD PTR DS: [<&MSUCRIOO.printf>] s "apii dad, 
MOU DWORD PTR SS:LHRG.11,0FFSET BBFF30Al ASCII "zero", case 0 of : ee alla 
JMP DWORD PTR DS: [<eMSUCRIBO. printf >] pa DIEEEEEEEEE 
INT > 7EFDDaaatFFF) 
BLFFFFFFFF) 


LastErr @ 906 ERROR 
66606262 (NO,NB,NE,A,N 


RETURN from 


ASCII ”pN#” 


FF FF FF FF 
FE FF FF FF| 81 
a a) 4 


4TuFiraKil 
(* hh 


rc 


Figure 1.43: OllyDbg: SUB executed 
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DEC is executed and EAX now contains 1. But 1 is non-zero, so the ZF flag is still 0: 


3B4424 04 MOU EAX, DWORD PTR SS: CARG. 1] 
83E8 68 SUB EAX, Ø 
74 30 Je SHORT 00FF1039 
48 DEC EAX 
74 1F Je GGFF162B 
48 DEC ERA 
Je SHORT GBFF181D : 
MOU DWORD PTR SS:CARG.1],OFFSET BaGFFS81: ASCII "something unknown 
DWORD PTR DS: L4&HSUCRIBB.printf?1 
DWORD PTR SS:CARG.1],OFFSET BOFF3B11 ASCII "two", case 2 of 
a DWORD PTR DS: [<2aMSUCR1BB. printf >] 
4 DWORD PTR SS:LRRG.13,0FFSET BOFF300: ASCII "one", case 1 of 
a DWORD PTR DS: L4&HSUCRIBB.printf?1 
a4 DWORD PTR SS:LRRG.13,0FFSET BOFF3001 ASCII "zercg", case 8 of 
a DWORD DS: [€&HSUCR188. printf?1 


Switch (cases @..2, 4 e 


74 BE 
074424 04 
FF25 FF Few. 
' GOFF1IGOA f 


bit G(FFFFFFFF) 
bit &(FFFFFFFF) 


Jump is not taken 
Dest=few. BOFF102B 


thin 


4TuFira Kil 
(* hN# 


Figure 1.44: OllyDbg: first DEC executed 
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Next DEC is executed. EAX is finally O and the ZF flag gets set, because the result is 
zero: 


CPU - main thread, module few 


$ 864424 64 | MOU EAX,DUORD PTR SS:IRRG.11 
- 83E8 00 SUB_EAX, a Switch (cases 8..2, 4 e A 
74 30 Je SHORT GoFF1039 ME scu nue 


48 ta] 
pe 1F ae mE DOFF102B 


74 GE de E — = 

pees 84 R SS:CARG.1],OFFSET BOFF361; ASCII "something unknown 
D PTR DS: [<2MSUCRIBB. pr int£ >I 
PTR SS: [ARG.11,OFFSET OBFF3011 ASCII "two", case 2 of 
PTR DS: [<2MSUCRIGO. printf >] 
PTR SS: HR 11,0FFSET BOFF300; ASCII "oneg", case 1 of 
PTR DS: L«&HSUCR18B.printf?1 
PTR SS: [ARG.11,OFFSET OOFF3001 ASCII "sero", case 8 of 
PTR DS: [<2MSUCRIGO. printf >] 


EP P. OoEE1o00 few. BOFF190D 


32bit BtFFFFFFFF) 
bit B(FFFFFFFF) 
bit G(FFFFFFFF) 
bit B(FFFFFFFF) 
bit 7EFDDGGG(FFF) 
bit GtFFFFFFFF) 


rom 
RETURN from f: 
CII "phe" 


8 4TuFiraKil 
H(* hN# 


Figure 1.45: OllyDbg: second DEC executed 


OllyDbg shows that this jump is to be taken now. 
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A pointer to the string "two" is to be written into the stack now: 


CPU - main thread, module few 


$ 8B4424 04 MOU EAX, DWORD PTR SS:[ARG.1] 
+ 83E8 00 SUB EAX, 0 Switch (cases 8..2, 4 e 
vy 74 30 JZ SHORT ØØFF1039 


48 
Je SHORT G@FF162B 


JZ SHORT @@FF101D E 
MOU DWORD PTR SS:LRRG.11,0FFSET BBFFS81iRSCII "something unknown E 
JMP DWORD PTR DS: [<2MSUCRIBO. printf >I ST ín 
à! MOU DWORD PTR SS:LHRG.11J,0FFSET GOFF3Q1IASCII "two", case 2 of 2 
a DWORD PTR DS: [<£MSUCRIGO. printf >I IP 


ü ^ BOFF1G1D f 
a4 DWORD PTR SS: CARG.11,OFFSET SGFF300; ASCII "one", case 1 of S 
a DWORD PTR DS:L4&HMSUCR188.printf»1 
a4 DWORD PTR SS: CARG.11,OFFSET BOFF3001 ASCII "zero", case 8 of 
a DWORD PTR DS:E4&MSUCR188.printf»1 


jit BG(FFFFFFFF) 

@( FFFFFFFF) 
jit G(FFFFFFFF) 
jit GCFFFFFFFF) 
jit PEFDDG@GG(FFF) 
@(FFFFFFFF) 


mm=few.@6FF3G16, ASCII 
Stack [Ø001EF850]=2 
Jump from BFF100D 


AAA 
E E Wd CH] = RETURN from 


ca 
unknownBl ASCII "pnw" 


8 4TuFipakil 
H(* hN# 


Figure 1.46: OllyDbg: pointer to the string is to be written at the place of the first 
argument 


Please note: the current argument of the function is 2 and 2 is now in the stack at 
the address 0x001EF850. 
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MOV writes the pointer to the string at address 0x001EF850 (see the stack window). 
Then, jump happens. This is the first instruction of the printf () function in MSVCR100.DLL 
(This example was compiled with /MD switch): 


CPU - main thread, module MSVCR100 


PUSH BC 
68 S056446F | PUSH 6E445638 

ES COBSFAFF | CALL 6E3Fa956 

33C8 XOR EAX, EAX 

XOR ESI, ESI 

CMP DWORD PTR SS: [EBP+8],ESI 
SETNE AL 

CMP EAX, ESI 

75 15 JNE SHORT 6E4455B3 
ES 72B2FAFF |CALL _errno 


C766 16000001 NOV DWORD PTR DS:[CEAX], 16 
ES DBS90200 


EDI 6 33 fe 
EIP 6E445584 M 


CHSUCR188. errno 
CONST 16 => EXDEU 
CALL . invalid parameter noinfo CHSUCR188. invalid parar 


100.printf 


E Gt FFFFFFFF) 

83C8 FF OR ERR,FFFFFFFF : 

EB 5F JMP SHORT 6E445612 A Oc EEEEEFEE) 

ES 78E4FRFF |CALL . iob func ; stad ald 

6A 20 PUSH 28 ) 7EFDDGGG( FFF) 
POP EBX @(FFFFFFFF) 


ADD EAX, EBX 
PUSH EAX 


(ss i1=1 
MSUCR100. 6E3FA9B9 


tuc] 
g unknown) 


ASCII "phe" 


8 4TuFrAKl 
H(# hh* 


Figure 1.47: OllyDbg: first instruction of printf() in MSVCR100.DLL 


Now printf() treats the string at 0Ox00FF3010 as its only argument and prints the 
string. 
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This is the last instruction of printf(): 


CPU - main thread, module MSVCR100 


5a PUSH ERX 
56 


PUSH ESI 
FF7S G8 PUSH DUORD PTR SS: [EBP«81 
EB 49E4FAFF |CALL -ib func 
5ü PUSH ERE ELLA 
EB 2E710108 |CALL 6E45 — 
8945 E4 rr RGU OWRD, PTR SS: LEBP-1C1, EAX gode 
tol unc P 
6303 ADD EAR, EBX EDI GeFFSSRS few M 
ES E m E à EIP pEMEGIZ M i 9E44561 
ES ACBOFBFF | CALL éEdgoenc HSUCRI8B. 6E4a6AC ; DIE IM EEEEEEEES 


FFFFFFFF) 
FFFFFFFF) 
bit B(FFFFFFFF) 
bit 7EFDDBGO(FFF) 
bit B(FFFFFFFF) 


ADD ESP,18 
pode te FEFFI MOY DWORD PTR SS: [EBP-4],-2 
EA Ctr aai CALL 6E445618 

MOU EAX, pn PTR SS: LEBP-1C1 
EN PEESFAFF CALL 6E3Fa995 


c3 RETN 
ES 13E4FAFF |CALL iob func 
8306 280 ADD ERX,28- 


A Se 


g unk n ownBl 


8  4TuFiaKil 
HC hh 


60/00 


ea o 


Figure 1.48: OllyDbg: last instruction of printf() in MSVCR100.DLL 


The string "two" has just been printed to the console window. 
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Now let's press F7 or F8 (step over) and return...not to f(), but rather to main(): 


CPU - main thread, module few 


6A 02 PUSH 2 feu. BOFFS 
ES R9FFFFFF |CRLL BGaFF1000 ; 
8304 04 EIP BOF 1057 Fev. OOFF1057 


ES por EA EHS C t B(FFFFFFFF) 
68 2014FFo9 | PUSH BØFF142A e E CE RECECCES 
ES Scósugdd | CALL GOFFISED 2 Í oo B FFFFFFFF) 
U EAX, DWORD PTR DS:L8FF38741 Só EFDDOOOUFEF) 
HOU DWORD PIR SS: ILOCAL. 01, OFFSET BOFFSI pAr few. üFF3064 OCFFFFFÉFF) 
PUSH DWORD PTR DS: COFF30781 A a a = 
OV DWORD PTR DS:[ØFF3064], EAX 08 - ~ AAA 3 ERR 
PUSH OFFSET BOFF3054 AraS = ASCII "Hüw" oe ee | d m 
PUSH OFFSET GaFFSa5S A ASCII "hw" SB EFL c D -E) 


'à1EF858, PTR to ASCII ”twog” 


———————— SCI] (ASI =o 


8 4TuFira Kil 
H(* hN# 


aa aa 
aa aa 


Figure 1.49: OllyDbg: return to main() 


Yes, the jump has been direct, from the guts of printf() to main(). Because 
RA in the stack points not to some place in f(), but rather to main(). And CALL 
0x00FF1000 has been the actual instruction which called f(). 


ARM: Optimizing Keil 6/2013 (ARM mode) 


.text:0000014C f1: 

.text:0000014C 00 00 50 E3 CMP RO, 40 

.text:00000150 13 OE 8F 02 ADREQ RO, aZero ; “zero\n" 
.text:00000154 05 00 00 OA BEQ loc 170 

.text:00000158 01 00 50 E3 CMP RO, #1 

.text:0000015C 4B OF 8F 02 ADREQ RO, a0ne ; “one\n" 
.text:00000160 02 00 00 OA BEQ loc 170 

.text:00000164 02 00 50 E3 CMP RO, #2 

.text:00000168 4A OF 8F 12 ADRNE RO, aSomethingUnkno ; "something 


unknown\n" 
.text:0000016C 4E OF 8F 02 ADREQ RO, aTwo ; “two\n" 
.text:00000170 
.text:00000170 loc 170: ; CODE XREF: f1+8 
.text:00000170 ; f1+14 
.text:00000170 78 18 00 EA B _ 2printf 


Again, by investigating this code we cannot say if it was a switch() in the original 
Source code, or just a pack of if() statements. 


Anyway, we see here predicated instructions again (like ADREQ (Equal)) which is trig- 
gered only in case RO = 0, and then loads the address of the string «zero\n» into RO. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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The next instruction BEQ redirects control flow to loc 170, if R0 — 0. 


An astute reader may ask, will BEQ trigger correctly since ADREQ it has already filled 
the RO register before with another value? 


Yes, it will since BEQ checks the flags set by the CMP instruction, and ADREQ does not 
modify any flags at all. 


The rest of the instructions are already familiar to us. There is only one call to 
printf(), at the end, and we have already examined this trick here (1.11.2 on 
page 71). At the end, there are three paths to printf(). 


The last instruction, CMP RO, #2, is needed to check if a = 2. 


If itis not true, then ADRNE loads a pointer to the string «something unknown |n» into 
RO, since a has already been checked to be equal to 0 or 1, and we can sure that the 
a Variable is not equal to these numbers at this point. And if R0 — 2, a pointer to the 
string «two\n» will be loaded by ADREQ into RO. 


ARM: Optimizing Keil 6/2013 (Thumb mode) 


. text: 000000D4 fl: 

.text:000000D4 10 B5 PUSH {R4,LR} 

. text: 000000D6 00 28 CMP RO, 40 

.text:000000D8 05 DO BEQ zero case 

.text:000000DA 01 28 CMP RO, #1 

.text:000000DC 05 DO BEQ one case 

.text:000000DE 02 28 CMP RO, #2 

.text:000000E0 05 DO BEQ two case 

.text:000000E2 91 AO ADR RO, aSomethingUnkno ; "something 
unknown Nn" 

.text:000000E4 04 EO B default case 

.text:000000E6 zero case: ; CODE XREF: f1+4 

.text:000000E6 95 AO ADR RO, aZero ; “zero\n" 

.text:000000E8 02 EO B default case 

.text:000000EA one case: ; CODE XREF: f1+8 

.text:000000EA 96 AO ADR RO, aOne ; “one\n" 

. text: Q00000EC 00 EO B default_case 

.text:000000EE two case: ; CODE XREF: f1+C 

.text:000000EE 97 AO ADR RO, aTwo ; “two\n" 

.text:000000F0 default case ; CODE XREF: f1+10 

.text:000000F0 ; f1+14 

.text:000000F0 06 FO 7E F8 BL . 2printf 

.text:000000F4 10 BD POP {R4,PC} 


As was already mentioned, it is not possible to add conditional predicates to most 
instructions in Thumb mode, so the Thumb-code here is somewhat similar to the 
easily understandable x86 CISC-style code. 


ARM64: Non-optimizing GCC (Linaro) 4.9 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


208 


.LC12: 
.string "zero" 
.LC13: 
.string "one" 
.LC14: 
.string "two" 
.LC15: 
.string "something unknown" 
f12: 
stp x29, x30, [sp, -32]! 
add x29, sp, 0 
str w0, [x29,28] 
ldr w0, [x29,28] 
cmp w0, 1 
beq .L34 
cmp w0, 2 
beq .L35 
cmp w0, wzr 
bne .L38 ; jump to default label 
adrp x0, .LC12 ; "zero" 
add x0, x0, :1012:.LC12 
bl puts 
b .L32 
.L34: 
adrp x0, .LC13 ; "one" 
add x0, x0, :1012:.LC13 
bl puts 
b .L32 
.L35: 
adrp x0, .LC14 ; "two" 
add x0, x0, :1012:.LC14 
bl puts 
b .L32 
.L38: 
adrp x0, .LC15 ; "something unknown" 
add x0, x0, :1012:.LC15 
bl puts 
nop 
.L32: 
ldp x29, x30, [sp], 32 
ret 


The type of the input value is int, hence register WO is used to hold it instead of the 
whole X60 register. 


The string pointers are passed to puts() using an ADRP/ADD instructions pair just like 
it was demonstrated in the "Hello, world!" example: 1.5.3 on page 32. 


ARM64: Optimizing GCC (Linaro) 4.9 


f12: 
cmp w0, 1 
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beq 
cmp 
beq 
cbz 
; default case 
adrp 
add 
b 
.L35: 
adrp 
add 
b 
.L32: 
adrp 
add 
b 
.L31: 
adrp 
add 
b 


.L31 

w0, 2 

.L32 

w0, .L35 

x0, .LC15 

x0, x0, :10o12: 
puts 

x0, .LC12 

x0, x0, :10o12: 
puts 

x0, .LC14 

x0, x0, :10o12: 
puts 

x0, .LC13 

x0, x0, :10o12: 
puts 


; "something unknown" 
.LC15 


; "zero" 
.LC12 


H u two" 
.LC14 


; "one" 
.LC13 


Better optimized piece of code. CBZ (Compare and Branch on Zero) instruction does 
jump if WO is zero. There is also a direct jump to puts() instead of calling it, like it 
was explained before: 1.21.1 on page 197. 


MIPS 
Listing 1.157: Optimizing GCC 4.4.5 (IDA) 
f: 
lui $gp, ( gnu local gp >> 16) 
; is it 1? 
li $v0, 1 
beq $a0, $v0, loc 60 
la $gp, ( gnu local gp € OxFFFF) ; branch delay slot 
; is it 2? 
li $v0, 2 
beq $a0, $v0, loc 4C 
or $at, $zero ; branch delay slot, NOP 
; jump, if not equal to 0: 
bnez $a0, loc 38 
or $at, $zero ; branch delay slot, NOP 
; zero case: 
lui $a0, ($LCO >> 16) # "zero" 
lw $t9, (puts & OxFFFF) ($gp) 
or gat, $zero ; load delay slot, NOP 
jr $t9 ; branch delay slot, NOP 
la $a0, ($LCO & OxFFFF) # "zero" ; branch delay slot 
loc 38: # CODE XREF: f+1C 
lui $a0, ($LC3 >> 16) # "something unknown" 
lw $t9, (puts & OxFFFF) ($gp) 
or $at, $zero ; load delay slot, NOP 
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jr $t9 
la $a0, ($LC3 & OxFFFF) # "something unknown" ; branch 
delay slot 

loc 4C: # CODE XREF: f+14 

lui $a0, ($LC2 >> 16) # "two" 

lw $t9, (puts € OxFFFF)($gp) 

or $at, $zero ; load delay slot, NOP 

jr $t9 

la $a0, ($LC2 & OxFFFF) # "two" ; branch delay slot 
loc 60: # CODE XREF: f+8 

lui $a0, ($LC1 >> 16) # "one" 

lw $t9, (puts € OxFFFF) ($gp) 

or $at, $zero ; load delay slot, NOP 

jr $t9 

la $a0, ($LC1 € OxFFFF) # "one" ; branch delay slot 


The function always ends with calling puts(), so here we see a jump to puts() (JR: 
"Jump Register") instead of "jump and link". We talked about this earlier: 1.21.1 on 
page 197. 


We also often see NOP instructions after LW ones. This is "load delay slot": another 
delay slot in MIPS. 


An instruction next to LW may execute at the moment while LW loads value from 
memory. 


However, the next instruction must not use the result of LW. 

Modern MIPS CPUs have a feature to wait if the next instruction uses result of LW, so 
this is somewhat outdated, but GCC still adds NOPs for older MIPS CPUs. In general, 
it can be ignored. 


Conclusion 

A switch() with few cases is indistinguishable from an if/else construction, for exam- 
ple: listing.1.21.1. 

1.21.2 Alot of cases 


If a switch() statement contains a lot of cases, it is not very convenient for the 
compiler to emit too large code with a lot JE/JNE instructions. 


#include <stdio.h> 


void f (int a) 
{ 
Switch (a) 
{ 
case 0: printf ("zero\n"); break; 
case 1: printf ("one\n"); break; 
case 2: printf ("two\n"); break; 
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case 3: printf ("three\n"); break; 
case 4: printf ("four\n"); break; 
default: printf ("Something unknown\n"); break; 
Hh 
}; 


int main() 


x86 
Non-optimizing MSVC 


We get (MSVC 2010): 
Listing 1.158: MSVC 2010 


tv64 = -4 ; size=4 
_ag = 8 ; size = 4 
_f PROC 

push ebp 

mov ebp, esp 

push ecx 


mov eax, DWORD PTR a$[ebp] 
mov DWORD PTR tv64[ebp], eax 
cmp DWORD PTR tv64[ebp], 4 
ja SHORT $LN1@f 
mov ecx, DWORD PTR tv64[ebp] 
jmp DWORD PTR $LN11@f [ecx*4] 

$LN6Gf : 
push OFFSET $5G739 ; 'zero', 0aH, 00H 
call printf 
add esp, 4 
jmp SHORT $LN9@f 

$LN5Qf : 
push OFFSET $SG741 ; 'one', 0aH, 00H 
call printf 
add esp, 4 
jmp SHORT $LN9@f 

$LN4@f : 
push OFFSET $SG743 ; 'two', 0aH, 00H 
call printf 
add esp, 4 
jmp SHORT $LN9@F 

$LN36f: 
push OFFSET $5G745 ; 'three', 0aH, OOH 
call printf 
add esp, 4 
jmp SHORT $LN9@F 

$LN2Gf : 
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push OFFSET $5G747 ; 'four', OaH, 00H 
call printf 
add esp, 4 
jmp SHORT $LN9@F 
$LN1@f : 
push OFFSET $SG749 ; ‘something unknown', OaH, 00H 
call printf 
add esp, 4 


$LN9Gf : 
mov esp, ebp 
pop ebp 
ret 0 
npad 2 ; align next label 
$LN11@f : 
DD $LN6gf ; 0 
DD $LN5@f ; 1 
DD $LNAGf ; 2 
DD $LN3eGf ; 3 
DD $LN2Gf ; 4 
_f ENDP 


What we see here is a set of printf() calls with various arguments. All they have 
not only addresses in the memory of the process, but also internal symbolic labels 
assigned by the compiler. All these labels are also mentioned in the $LN11@f internal 
table. 


At the function start, if a is greater than 4, control flow is passed to label $LN1@f, 
where printf() with argument ' something unknown' is called. 


But if the value of a is less or equals to 4, then it gets multiplied by 4 and added with 
the $LN11@f table address. That is how an address inside the table is constructed, 
pointing exactly to the element we need. For example, let's say a is equal to 2. 
2 * 4 = 8 (all table elements are addresses in a 32-bit process and that is why all 
elements are 4 bytes wide). The address of the $LN11@f table + 8 is the table 
element where the $LN4@f label is stored. JMP fetches the $LN4@f address from the 
table and jumps to it. 


This table is sometimes called jumptable or branch table?^. 


Then the corresponding printf() is called with argument ' two'. 
Literally, the jmp DWORD PTR $LN11@f [ecx*4] instruction implies jump to the DWORD 
that is stored at address $LN11@f + ecx * 4. 


npad (.1.7 on page 1313) is an assembly language macro that align the next label so 
that it will be stored at an address aligned on a 4 bytes (or 16 bytes) boundary. This 
is very suitable for the processor since it is able to fetch 32-bit values from memory 
through the memory bus, cache memory, etc., in a more effective way if it is aligned. 


35The whole method was once called computed GOTO in early versions of Fortran: wikipedia. Not quite 
relevant these days, but what a term! 
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OllyDbg 


Let's try this example in OllyDbg. The input value of the function (2) is loaded into 
EAX: 


55 PUSH EBP 
SBEC MOU EBP,ESP 
51 PUSH ECX 

8845 08 MOU EAX, DWORD PTR SS:[EBP+8] 
8945 FC MOU DWORD PTR SS: CEBP-4],EAX 
8370 FC 64 |CMP_DWORD PTR SS:LEBP-41,4 
?? 5A JA SHORT 610B106A 

8B4D FC MOV ECX, DWORD PTR SS: [EBP-4] 
FF248D 20196] JMP DWORD PTR DS: [ECX*4+10B107C] 
68 PUSH OFFSET 01083000 format = bip: 
ELEME PTR DS: (<&MSUCR1IG@G.printf>] [LMSUCRIGO, ^ 01081007 


JMP SHORT 81081078 ; 5 ES 


t @(FFFFFFFF) 


PUSH OFFSET 01063008 format = aaa 
CALL DWORD PTR DS: C<sMsucRiad.printf>] [Unsucrioo. |^ it Ot EEPEEREES 
ADD ESP, 4 1 it PEFDDOGBLFFF) 
JMP SHORT 01081078 3 32bit ØCFFFFFFFF) 


PUSH OFFSET 01063010 format = 


pea PTR DS: [<8MSUCR100.printf>]1 [LMSUCRIDO, 7 > : SUCCESS 
JMP SHORT 01081078 5 E, NS, PE, GE, LE) 


RETURN from Lot 


RETURN from Lot 


B — brhsesdrT 
Hie hNe 


Figure 1.50: OllyDbg: function's input value is loaded in EAX 
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The input value is checked, is it bigger than 4? If not, the "default" jump is not taken: 


CPU - main thread, module lot 


55 PUSH EBP 

SBEC MOU EBP,ESP 

51 PUSH ECX 

SB45 88 MOU EAX, DWORD PTR SS: [EBP+8] 
8945 FC MOV DWORD PTR SS: [EBP-4],EAX 
cae FC 64 | CMP DWORD PTR SS: [EBP-41,4 

eve 22 SA JA SHORT 010B106A 

8B4D FC MOU ECX, DWORD PTR SS: [EBP-4] 
FF2480 7C100/ JMP DWORD PTR DS: [ECX*4+10B107C] o 
68 gaasoüpal [PUSH OFFSET 91663000 format = 
CALL DWORD PTR DS: [<8MSUCR1B0.printf>1 [LMSUCRIDO. 
ADD ESP, 4 

JMP SHORT 01081078 
PUSH OFFSET 01063008 format = 
CALL DWORD PTR DS:[<&MSUCR100.printf>] |CMSUCR100, 
ADD ESP, 4 

JMP SHORT 01061078 
PUSH OFFSET 01063010 format = 
CALL QUORD PTR DS: ([<&MSUCRIG@.printf>] | LMSUCR1a0, LastÉre 
ADD ESP mic 
JMP SHORT 01081078 Pe 98986293 


— initenv 


O10E100E 


ES BLFFFFFFFF) 


Bt FFFFFFFF) 


FFFFFFFF) 
7EFDDGGO( FFF) 
BLFFFFFFFF) 


bit 


)O dor mD7o00 m mmmmmm mri 


unknown) 


B  'brh*esr 
Hie hhe 


Figure 1.51: OllyDbg: 2 is no bigger than 4: no jump is taken 
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Here we see a jumptable: 


MSUCR188.printf?1 


&HSUCR1868.printf»1 


85 C8 79 48 6A 88 ES AB a2 

ES 68 05 66 66 

75 BB 53 53 6A 61 53 FF 

FC 64 Al 18 00 G6 GB SB 70 
BF BS 33 68 01 53 56 57 FF 15 20 20 OB 01 3 
74 19 C6 75 08 33 F6 46 89 75 E4 EB 10 € 
63 00 00 FF 15.24 20 OB 01 EB DA 33 F6 46 Al 


format = 


MSUCR188, 


format = 


MSUCR188. 


format = 


MSUCR188. 


Bt FFFFFFFF) 
BLFFFFFFFF) 
7EFDDaaatFFF) 
OCFFFFFFFF) 


8| RETURN from lot.B10B100t 


98| RETURN from lot.B10B109€ 


Figure 1.52: OllyDbg: calculating destination address using jumptable 


Here we've clicked “Follow in Dump” > “Address constant”, so now we see the jumpt- 
able in the data window. These are 5 32-bit values?6. ECX is now 2, so the third 
element (can be indexed as 2?7) of the table is to be used. It's also possible to click 
“Follow in Dump” > “Memory address” and OllyDbg will show the element addressed 


by the JMP instruction. That's 0x010B103A. 


“They are underlined by OllyDbg because these are also FIXUPs: 6.5.2 on page 967, we are going to 


come back to them later 
97 About indexing, see also: 3.22.3 on page 753 
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After the jump we are at 0x010B103A: the code printing "two" will now be executed: 


- main thread, module lot 

Ed PUSH EBP 

SBEC MOU EBP,ESP 

51 PUSH ECX 

8B45 08 MOU EAX, DWORD PTR SS: [EBP+8] 

8945 FC MOU DWORD PTR SS: LEBP-41,ERX 

8370 FC 04 |CMP DWORD PTR SS:[EBP-41,4 

77 5A JA SHORT 818B186n 

8B4D FC MOU ECX, DWORD PTR SS:LEBP-41 

FF248D 70100) JMP DWORD PTR DS: [ECX*4+108197C] TS 

68 GO300R01 |PUSH OFFSET 01083008 [iernat = "zerg ot. 818 

FF15 Ab2aaBal CALL DWORD PTR DS: [<&MSUCR100. pr i| LMSUCRIG0. print? > G1OB1G3A lot.819B103| 
ADI n B(FFFFFFFF) 

JMP SHORT 01081078 ; BIEEREEEEE) 

PUSH OFFSET 91083008 format = "oneal" A EFEEFFFE) 

CALL DWORD PTR DS: (<&MSUCRIO0. pr i LHISUCRI8O. printf MEE 

She SHORT 91081078 Sb E CEEDOSBOEEE TI 

PUSH OFFSET 91083010 | Cfonnat= ewe BIFFEFEEEES 

CALL DUORD PTR DS: E<AMSUCRIGO. pr (LTISUCRTO0. printf J ; 


JMP SHORT 01061078 


Figure 1.53: OllyDbg: now we at the case: label 


Non-optimizing GCC 


Let's see what GCC 4.4.1 generates: 
Listing 1.159: GCC 4.4.1 


public f 
f proc near ; CODE XREF: main+10 


var 18 - dword ptr -18h 
arg 0 - dword ptr 8 


push ebp 

mov ebp, esp 

sub esp, 18h 

cmp [ebp+arg 0], 4 

ja short loc 8048444 

mov eax, [ebptarg 0] 

shl eax, 2 

mov eax, ds:off 804855C[eax] 
jmp eax 


loc 80483FE: ; DATA XREF: .rodata:off 804855C 


mov [esp+18h+var_18], offset aZero ; "zero" 
call | puts 
jmp short locret 8048450 
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DATA XREF: .rodata:08048560 


loc 804840C: 


mov [esp-18h-var 18], offset aOne ; "one" 
call | puts 
jmp short locret 8048450 
loc 804841A: ; DATA XREF: .rodata:08048564 
mov [esp-18h-var 18], offset aTwo ; "two" 
call | puts 
jmp short locret 8048450 
loc 8048428: ; DATA XREF: .rodata:08048568 
mov [esp-18h-var 18], offset aThree ; "three" 
call | puts 
jmp short locret 8048450 
loc 8048436: ; DATA XREF: .rodata:0804856C 
mov [esp+18h+var_18], offset aFour ; "four" 
call | puts 
jmp short locret 8048450 
loc 8048444: ; CODE XREF: f+A 
mov [esp+18h+var_ 18], offset aSomethingUnkno ; "something unknown" 
call | puts 
locret 8048450: ; CODE XREF: f+26 
; 434... 
leave 
retn 
f endp 
off 804855C dd offset loc 80483FE ; DATA XREF: f+12 


dd offset loc 804840C 
dd offset loc 804841A 
dd offset loc 8048428 
dd offset loc 8048436 


It is almost the same, with a little nuance: argument arg 0 is multiplied by 4 by 
shifting it to left by 2 bits (it is almost the same as multiplication by 4) (1.24.2 on 
page 274). Then the address of the label is taken from the of f_ 804855C array, stored 
in EAX, and then JMP EAX does the actual jump. 


ARM: Optimizing Keil 6/2013 (ARM mode) 


Listing 1.160: Optimizing Keil 6/2013 (ARM mode) 


00000174 f2 

00000174 05 00 50 E3 CMP RO, #5 ; Switch 5 cases 

00000178 00 F1 8F 30 ADDCC PC, PC, RO,LSLZ2 ; switch jump 

0000017C OE 00 00 EA B default case ; jumptable 00000178 
default case 

00000180 

00000180 loc 180 ; CODE XREF: f2+4 
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00000180 


00000184 
00000184 
00000184 


00000188 
00000188 
00000188 


0000018C 
0000018C 
0000018C 


00000190 
00000190 
00000190 


00000194 
00000194 
00000194 
00000194 
00000198 


0000019C 
0000019C 
0000019C 
0000019C 
000001A0 


000001A4 
000001A4 
000001A4 
000001A4 
000001A8 


000001AC 
000001AC 
000001AC 
000001AC 
000001B0 


000001B4 
000001B4 
000001B4 
000001B4 
000001B8 
000001B8 
000001B8 
000001B8 


000001BC 
000001BC 


03 


04 


05 


06 


07 


EC 
06 


EC 
04 


01 
02 


01 
00 


01 


66 


00 


00 


00 


00 


00 


00 
00 


00 
00 


oC 
00 


OC 
00 


oC 


18 


00 


00 


00 


00 


00 


8F 
00 


8F 
00 


8F 
00 


8F 
00 


8F 


00 


EA 


EA 


EA 


EA 


EA 


E2 


E2 
EA 


E2 


E2 
EA 


E2 


EA 


B zero_case ; 


loc 184 ; CODE XREF: f2+4 
B one case ; 


loc 188 ; CODE XREF: f2+4 
B two case E 


loc 18C ; CODE XREF: f2+4 
B three case ; 


loc 190 ; CODE XREF: f244 
B four case ; 


zero case ; CODE XREF: f2+4 


; f2:loc 180 
ADR RO, aZero A 
B loc 1B8 


one case ; CODE XREF: f2+4 


; f2:loc 184 
ADR RO, a0ne ; 
B loc 1B8 


two case ; CODE XREF: f2+4 


; f2:loc 188 
ADR RO, aTwo i 
B loc_1B8 


three_case ; CODE XREF: f2+4 


; f2:loc_18C 
ADR RO, aThree ; 
B loc 1B8 


four case ; CODE XREF: f2+4 


; f2:loc 190 
ADR RO, aFour s 
loc_1B8 ; CODE XREF: f2+24 
; f2+2C 
B _ 2printf 


default_case ; CODE XREF: f2+4 


jumptable 


jumptable 


jumptable 


jumptable 


jumptable 


jumptable 


jumptable 


jumptable 


jumptable 


jumptable 


00000178 


00000178 


00000178 


00000178 


00000178 


00000178 


00000178 


00000178 


00000178 


00000178 


case 1 


case 2 


case 3 


case 4 


case 0 


case 1 


case 2 


case 3 


case 4 
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000001BC ; f248 

000001BC D4 00 8F E2 ADR RO, aSomethingUnkno ; jumptable 00000178 
default case 

| 990001C0 FC FF FF EA B loc 1B8 | 


This code makes use of the ARM mode feature in which all instructions have a fixed 
size of 4 bytes. 


Let's keep in mind that the maximum value for a is 4 and any greater value will cause 
«something unknown» string to be printed. 


The first CMP RO, #5 instruction compares the input value of a with 5. 


°8 The next ADDCC PC, PC, RO,LSL#2 instruction is being executed only if RO < 5 
(CC=Carry clear / Less than). Consequently, if ADDCC does not trigger (it is a R02 5 
case), a jump to default case label will occur. 


But if R0 « 5 and ADDCC triggers, the following is to be happen: 


The value in RO is multiplied by 4. In fact, LSL#2 at the instruction's suffix stands for 
"shift left by 2 bits". But as we will see later (1.24.2 on page 274) in section "Shifts", 
shift left by 2 bits is equivalent to multiplying by 4. 


Then we add RO + 4 to the current value in PC, thus jumping to one of the B (Branch) 
instructions located below. 


At the moment of the execution of ADDCC, the value in PC is 8 bytes ahead (0x180) 
than the address at which the ADDCC instruction is located (0x178), or, in other words, 
2 instructions ahead. 


This is how the pipeline in ARM processors works: when ADDCC is executed, the 
processor at the moment is beginning to process the instruction after the next one, 
so that is why PC points there. This has to be memorized. 


If a = 0, then is to be added to the value in PC, and the actual value of the PC will be 
written into PC (which is 8 bytes ahead) and a jump to the label /oc 180 will happen, 
which is 8 bytes ahead of the point where the ADDCC instruction is. 


If a = 1, then PC+8+a+*4= PC+8+4+1+4= PC 4-12 = 07184 will be written to PC, which 
is the address of the /oc 184 label. 


With every 1 added to a, the resulting PC is increased by 4. 


4 is the instruction length in ARM mode and also, the length of each B instruction, of 
which there are 5 in row. 


Each of these five B instructions passes control further, to what was programmed in 
the switch(). 


Pointer loading of the corresponding string occurs there, etc. 


ARM: Optimizing Keil 6/2013 (Thumb mode) 


98ADD—addition 
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Listing 1.161: Optimizing Keil 6/2013 (Thumb mode) 


000000F6 
000000F6 
000000F6 10 B5 
000000F8 03 00 


000000FA 06 FO 69 F8 
cases 


000000FE 05 
000000FF 04 06 08 0A OC 10 


switch statement 
00000105 00 


00000106 
00000106 
00000106 8D AO 
00000108 06 EO 


0000010A 
0000010A 
0000010A 8E AO 
0000010C 04 EO 


0000010E 
0000010E 
0000010E 8F AO 
00000110 02 EO 


00000112 
00000112 
00000112 90 AO 
00000114 00 EO 


00000116 

00000116 

00000116 91 AO 
00000118 

00000118 

00000118 

00000118 06 FO 6A F8 
0000011C 10 BD 


0000011E 
0000011E 
ss 82 A0 


00000FA pue redes case 
00000120 FA E 


000061D0 

000061D0 
example6 f2+4 

000061D0 78 47 


000061D2 00 00 
000061D2 


EXPORT f2 

f2 
PUSH {R4,LR} 
MOVS R3, RO 


BL . ARM common switch8 thumb ; switch 6 
DCB 5 
DCB 4, 6, 8, OxA, OxC, 0x10 ; jump table for 
ALIGN 2 

zero case ; CODE XREF: f2+4 
ADR RO, aZero ; jumptable 000000FA case 0 
B loc 118 


one case ; CODE XREF: f2+4 
ADR RO, a0ne ; jumptable 000000FA case 1 
B loc 118 


two case ; CODE XREF: f2+4 
ADR RO, aTwo ; jumptable 000000FA case 2 
B loc 118 


three case ; CODE XREF: f244 
ADR RO, aThree ; jumptable 000000FA case 3 
B loc 118 


four case ; CODE XREF: f2+4 


ADR RO, aFour ; jumptable 000000FA case 4 
loc 118 ; CODE XREF: f2+12 
; f2+16 
BL . 2printf 
POP (R4, PC) 


default case ; CODE XREF: f2+4 
ADR RO, aSomethingUnkno ; jumptable 


B loc 118 


EXPORT X ARM common switch8 thumb 


. ARM common switch8 thumb ; CODE XREF: 


BX PC 


ALIGN 4 
; End of function X ARM common switch8 thumb 
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000061D2 
000061D4 32 ARM common switch8 thumb ; CODE XREF: 
ARM common switch8 thumb 
000061D4 01 CO 5E E5 LDRB R12, [LR,#-1] 
000061D8 OC 00 53 El CMP R3, R12 
000061DC OC 30 DE 27 LDRCSB R3, [LR,R12] 
000061E0 03 30 DE 37 LDRCCB R3, [LR,R3] 
000061E4 83 CO 8E EO ADD R12, LR, R3,LSL#1 
000061E8 1C FF 2F El BX R12 
000061E8 ; End of function 32 ARM common switch8 thumb 


One cannot be sure that all instructions in Thumb and Thumb-2 modes has the same 
size. It can even be said that in these modes the instructions have variable lengths, 
just like in x86. 


So there is a special table added that contains information about how much cases 
are there (not including default-case), and an offset for each with a label to which 
control must be passed in the corresponding case. 


A special function is present here in order to deal with the table and pass control, 
named ARM common switch8 thumb. It starts with BX PC, whose function is to 
switch the processor to ARM-mode. Then you see the function for table processing. 


It is too advanced to describe it here now, so let's omit it. 
It is interesting to note that the function uses the LR register as a pointer to the table. 


Indeed, after calling of this function, LR contains the address after 
BL — ARM common switch8 thumb instruction, where the table starts. 


It is also worth noting that the code is generated as a separate function in order to 
reuse it, so the compiler doesn't generate the same code for every switch() state- 
ment. 


IDA successfully perceived it as a service function and a table, and added comments 
to the labels like 
jumptable 000000FA case 0. 


MIPS 


Listing 1.162: Optimizing GCC 4.4.5 (IDA) 


f: 
lui $gp, ( gnu local gp >> 16) 
; jump to loc 24 if input value is lesser than 5: 
sltiu $v0, $a0, 5 
bnez $v0, loc 24 
la $gp, ( gnu local gp € OxFFFF) ; branch delay slot 
; input value is greater or equal to 5. 
; print "something unknown" and finish: 


lui $a0, ($LC5 >> 16) # "something unknown" 
lw $t9, (puts € OxFFFF) ($gp) 

or $at, $zero ; NOP 

jr $t9 
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la $a0, ($LC5 & OxFFFF) # "something unknown" ; branch 
delay slot 


loc 24: # CODE XREF: f+8 
; load address of jumptable 
; LA is pseudoinstruction, LUI and ADDIU pair are there in fact: 


la $v0, off 120 
; multiply input value by 4: 
sll $a0, 2 


; sum up multiplied value and jumptable address: 
addu $a0, $v0, $a0 
; load element from jumptable: 


lw $v0, 0($a0) 

or $at, $zero ; NOP 
; Jump to the address we got in jumptable: 

jr $v0 

or $at, $zero ; branch delay slot, NOP 
sub_44: # DATA XREF: .rodata:0000012C 
; print "three" and finish 

lui $a0, ($LC3 >> 16) # "three" 

lw $t9, (puts & OxFFFF) ($gp) 

or $at, $zero ; NOP 

jr $t9 

la $a0, ($LC3 & OxFFFF) # "three" ; branch delay slot 
sub 58: # DATA XREF: .rodata:00000130 
; print "four" and finish 

lui $a0, ($LC4 >> 16) # "four" 

lw $t9, (puts & OxFFFF) ($gp) 

or $at, $zero ; NOP 

jr $t9 

la $a0, ($LC4 & OxFFFF) # "four" ; branch delay slot 
sub 6C: # DATA XREF: .rodata:off 120 
; print "zero" and finish 

lui $a0, ($LCO >> 16) # "zero" 

lw $t9, (puts & OxFFFF) ($gp) 

or $at, $zero ; NOP 

jr $t9 

la $a0, ($LCO & OxFFFF) # "zero" ; branch delay slot 
sub 80: # DATA XREF: .rodata:00000124 
; print "one" and finish 

lui $a0, ($LC1 >> 16) # "one" 

lw $t9, (puts & OxFFFF) ($gp) 

or $at, $zero ; NOP 

jr $t9 

la $a0, ($LC1 € OxFFFF) # "one" ; branch delay slot 
sub 94: # DATA XREF: .rodata:00000128 
; print "two" and finish 

lui $a0, ($LC2 >> 16) # "two" 

lw $t9, (puts € OxFFFF) ($gp) 
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or $at, $zero ; NOP 
jr $t9 
la $a0, ($LC2 & OxFFFF) # "two" ; branch delay slot 


; may be placed in .rodata section: 
off 120: .word sub 6C 

.word sub 80 

.word sub 94 

.word sub 44 

.word sub 58 


The new instruction for us is SLTIU ("Set on Less Than Immediate Unsigned"). 


This is the same as SLTU ("Set on Less Than Unsigned"), but "I" stands for "immedi- 
ate", i.e., a number has to be specified in the instruction itself. 


BNEZ is "Branch if Not Equal to Zero". 


Code is very close to the other ISAs. SLL ("Shift Word Left Logical") does multiplica- 
tion by 4. 


MIPS is a 32-bit CPU after all, so all addresses in the jumptable are 32-bit ones. 


Conclusion 
Rough skeleton of switch(): 
Listing 1.163: x86 


MOV REG, input 

CMP REG, 4 ; maximal number of cases 

JA default 

SHL REG, 2 ; find element in table. shift for 3 bits in x64. 
MOV REG, jump table[REG] 

JMP REG 


casel: 
; do something 
JMP exit 
case2: 
; do something 
JMP exit 
case3: 
; do something 
JMP exit 
case4: 
; do something 
JMP exit 
case5: 
; do something 
JMP exit 


default: 
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exit: 


jump table dd casel 
dd case2 
dd case3 
dd case4 
dd case5 


The jump to the address in the jump table may also be implemented using this 
instruction: 
JMP jump table[REG*4]. Or JMP jump table[REG*8] in x64. 


A jumptable is just array of pointers, like the one described later: 1.26.5 on page 354. 


1.21.3 When there are several case statements in one block 


Here is a very widespread construction: several case statements for a single block: 


#include <stdio.h> 


void f(int a) 


{ 

switch (a) 

{ 

case 1 

case 2: 

case 7: 

case 10: 
printf ("1, 2, 7, 10\n"); 
break; 

case 3: 

case 4: 

case 5: 

case 6: 
printf ("3, 4, 5\n"); 
break; 

case 8: 

case 9: 

case 20: 

case 21: 
printf ("8, 9, 21\n"); 
break; 

case 22: 
printf ("22\n"); 
break; 

default: 
printf ("default\n"); 
break; 

un 
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y 
int main() 
{ 
f(4); 
Fi 


It's too wasteful to generate a block for each possible case, so what is usually done 
is to generate each block plus some kind of dispatcher. 


MSVC 
Listing 1.164: Optimizing MSVC 2010 
$SG2798 DB '1, 2, 7, 10', 0aH, 00H 
$SG2800 DB '3, 4, 5', OaH, 00H 
$SG2802 DB '8, 9, 21', 0aH, OOH 
$SG2804 DB '22', 0aH, 00H 
$SG2806 DB 'default', OaH, 00H 
_ag = 8 
_f PROC 
mov eax, DWORD PTR  a$[esp-4] 
dec eax 
cmp eax, 21 
ja SHORT $LN1@f 
movzx eax, BYTE PTR $LN10@f [eax] 
jmp DWORD PTR $LN11@f [eax*4] 
$LN5@f : 
mov DWORD PTR _a$[esp-4], OFFSET $5G2798 ; ‘1, 2, 7, 10' 
jmp DWORD PTR _imp_ printf 
$LN4@f : 
mov DWORD PTR _a$[esp-4], OFFSET $SG2800 ; '3, 4, 5' 
jmp DWORD PTR _imp_ printf 
$LN3@f : 
mov DWORD PTR _a$[esp-4], OFFSET $5G2802 ; '8, 9, 21' 
jmp DWORD PTR _imp_ printf 
$LN2@f : 
mov DWORD PTR a$[esp-4], OFFSET $5G2804 ; '22' 
jmp DWORD PTR _imp_ printf 
$LN1@f : 
mov DWORD PTR a$[esp-4], OFFSET $5G2806 ; ‘default’ 
jmp DWORD PTR imp printf 
npad 2 ; align $LN11@f table on 16-byte boundary 
$LN11@f : 
DD $LN5@f ; print '1, 2, 7, 10' 
DD $LNAGf ; print '3, 4, 5' 
DD $LN3Gf ; print '8, 9, 21' 
DD $LN2Gf ; print '22' 
DD $LN1@f ; print 'default' 
$LN10@f : 
DB 0; a=1 
DB 0; a=2 
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DB 1; a=3 
DB 1; a=4 
DB 1; a=5 
DB 1; a=6 
DB 0 ; a=7 
DB 2 ; a-8 
DB 2 ; a-9 
DB 0 ; a-10 
DB 4 ; a-11 
DB 4 ; a-12 
DB 4 ; a-13 
DB 4 ; a-14 
DB 4 ; a-15 
DB 4 ; a-16 
DB 4 ; a-17 
DB 4 ; a-18 
DB 4 ; a-19 
DB 2 ; a-20 
DB 2 ; a-21 
DB 3 ; a-22 
f ENDP 


We see two tables here: the first table ($LN10@f) is an index table, and the second 
one ($LN11@f) is an array of pointers to blocks. 


First, the input value is used as an index in the index table (line 13). 


Here is a short legend for the values in the table: 0 is the first case block (for values 
1, 2, 7, 10), 1 is the second one (for values 3, 4, 5),2 is the third one (for values 8, 
9, 21), 3 is the fourth one (for value 22), 4 is for the default block. 


There we get an index for the second table of code pointers and we jump to it (line 
14). 


What is also worth noting is that there is no case for input value 0. 


That's why we see the DEC instruction at line 10, and the table starts at a — 1, because 
there is no need to allocate a table element for a — 0. 


This is a very widespread pattern. 

So why is this economical? Why isn't it possible to make it as before (1.21.2 on 
page 216), just with one table consisting of block pointers? The reason is that the 
elements in index table are 8-bit, hence it's all more compact. 

GCC 

GCC does the job in the way we already discussed (1.21.2 on page 216), using just 
one table of pointers. 

ARM64: Optimizing GCC 4.9.1 


There is no code to be triggered if the input value is 0, so GCC tries to make the jump 
table more compact and so it starts at 1 as an input value. 
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GCC 4.9.1 for ARM64 uses an even cleverer trick. It's able to encode all offsets as 
8-bit bytes. 


Let's recall that all ARM64 instructions have a size of 4 bytes. 


GCC is uses the fact that all offsets in my tiny example are in close proximity to each 
other. So the jump table consisting of single bytes. 


Listing 1.165: Optimizing GCC 4.9.1 ARM64 


f14: 
; input value in WO 
sub wO, w0, #1 
cmp w0, 21 
; branch if less or equal (unsigned): 
bls .L9 
.L2: 
; print "default": 
adrp x0, .LC4 
add x0, x0, :lo12:.LC4 
b puts 
.L9: 
; load jumptable address to X1: 
adrp x1, .L4 
add x1, x1, :lo12:.L4 
WO-input value-1 
load byte from the table: 
ldrb w0, [x1,w0,uxtw] 
load address of the Lrtx Label: 
adr x1, .Lrtx4 
multiply table element by 4 (by shifting 2 bits left) and add (or subtract) 


to the address of Lrtx: 
add x0, x1, w0, sxtb #2 


; jump to the calculated address: 


br x0 
; this label is pointing in code (text) segment: 
.Lrtx4: 

.section .rodata 


; everything after ".section" statement is allocated in the read-only data 
(rodata) segment: 


.L4: 
.byte (.L3 - .Lrtx4) / 4 ; case 1 
.byte (.L3 - .Lrtx4) / 4 ; case 2 
.byte (.L5 - .Lrtx4) / 4 ; case 3 
.byte (.L5 - .Lrtx4) / 4 ; case 4 
.byte (.L5 - .Lrtx4) / 4 ; case 5 
.byte (.L5 - .Lrtx4) / 4 ; case 6 
.byte (.L3 - .Lrtx4) / 4 ; case 7 
.byte (.L6 - .Lrtx4) / 4 ; case 8 
.byte (.L6 - .Lrtx4) / 4 ; case 9 
.byte (.L3 - .Lrtx4) / 4 ; case 10 
.byte (.L2 - .Lrtx4) / 4 ; case 11 
.byte (.L2 - .Lrtx4) / 4 ; case 12 
.byte (.L2 - .Lrtx4) / 4 ; case 13 
.byte (.L2 - .Lrtx4) / 4 ; case 14 
.byte (.L2 - .Lrtx4) / 4 ; case 15 
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.byte (.L2 - .Lrtx4) 
.byte (.L2 - .Lrtx4) 
.byte (.L2 - .Lrtx4) 
.byte (.L2 - .Lrtx4) 
.byte (.L6 - .Lrtx4) 
.byte (.L6 - .Lrtx4) 
.byte (.L7 - .Lrtx4) 
.text 


NA A 0M CM 
PHHHHHHA 


; case 16 
; case 17 
; case 18 
; case 19 
; case 20 
; case 21 
; case 22 


; everything after ".text" statement is allocated in the code (text) segment: 


.L7: 
; print 


.L6: 
; print 


«L5 
; print 


.L3: 
; print 


.LC0: 
.LC1: 
.LC2: 
.LC3: 


.LC4: 


"22" 
adrp x0, .LC3 

add x0, x0, :lo12:. 
b puts 

"8, 9, 21" 

adrp x0, .LC2 

add x0, x0, :lo12: 
b puts 

"3,4, 5" 

adrp x0, .LC1 

add x0, x0, :lo12:. 
b puts 

"d, 7, L0" 

adrp x0, .LCO 

add x0, x0, :lol2: 
b puts 


.string "1, 2, 7, 10" 
.string "3, 4, 5" 
.string "8, 9, 21" 
.string "22" 


.string "default" 


LC3 


.LC2 


.LCO 


Let’s compile this example to object file and open it in IDA. Here is the jump table: 


Listing 1.166: jumptable in IDA 


.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 


:0000000000000064 
:0000000000000064 
:0000000000000064 $d 
:0000000000000065 
:0000000000000066 
:0000000000000067 
:0000000000000068 
:0000000000000069 
:000000000000006A 
:000000000000006B 


AREA .rodata, 
; ORG 0x64 

DCB 
DCB 
DCB 
DCB 
DCB 
DCB 
DCB 
DCB 


UJ) (O O») O» O) O» (oO tO 


DATA, READONLY 


case 
case 
case 
case 
case 
case 
case 
case 


0 Y OY Ui 4» YN 
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. rodata : 000000000000006C DCB 3 ; case 9 

. rodata:000000000000006D DCB 9 ; case 10 
.rodata:000000000000006E DCB 0xF7 ; case 11 
.rodata:000000000000006F DCB 0xF7 ; case 12 
.rodata:0000000000000070 DCB 0xF7 ; case 13 
. rodata:0000000000000071 DCB OxF7 ; case 14 
. rodata : 0000000000000072 DCB 0xF7 ; case 15 
. rodata : 0000000000000073 DCB 0xF7 ; case 16 
. rodata : 0000000000000074 DCB 0xF7 ; case 17 
. rodata : 0000000000000075 DCB 0xF7 ; case 18 
. rodata : 0000000000000076 DCB 0xF7 ; case 19 
. rodata : 0000000000000077 DCB 3 ; case 20 
. rodata : 0000000000000078 DCB 3 ; case 21 
. rodata : 0000000000000079 DCB 0 ; case 22 


.Fodata:000000000000007B ; .rodata ends 


So in case of 1, 9 is to be multiplied by 4 and added to the address of Lrtx4 label. 
In case of 22, 0 is to be multiplied by 4, resulting in O. 


Right after the Lrtx4 label is the L7 label, where you can find the code that prints 
422". 


There is no jump table in the code segment, it's allocated in a separate .rodata 
section (there is no special necessity to place it in the code section). 


There are also negative bytes (OxF7), they are used for jumping back to the code 
that prints the "default" string (at .L2). 
1.21.4 Fall-through 


Another popular usage of switch() operator is so-called “fallthrough”. Here is sim- 
ple example??: 


bool is whitespace(char c) { 
switch (c) 1 
case ' ': // fallthrough 
case '\t': // fallthrough 
case '\r': // fallthrough 
case 'An': 
return true; 
default: // not whitespace 
return false; 


Slightly harder, from Linux kernel!9?: 


char ncol, nco2; 


99Copypasted from  https://github.com/azonalon/prgraas/blob/master/progllib/lecture 
examples/is whitespace.c 

100Copypasted from https://github.com/torvalds/linux/blob/master/drivers/media/ 
dvb- frontends/lgdt3306a.c 
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void f(int if freq khz) 
1 
switch (if freq khz) { 
default: 
printf("IF=%d KHz is not supportted, 3250 assumed\n/ 
V ", if freq khz); 
/* fallthrough */ 
case 3250: /* 3.25Mhz */ 
ncol - 0x34; 
nco2 - 0x00; 
break; 
case 3500: /* 3.50Mhz */ 
ncol - 0x38; 
nco2 - 0x00; 
break; 
case 4000: /* 4.00Mhz */ 
ncol - 0x40; 
nco2 - 0x00; 
break; 
case 5000: /* 5.00Mhz */ 
ncol - 0x50; 
nco2 - 0x00; 
break; 
case 5380: /* 5.38Mhz */ 
ncol - 0x56; 
nco2 - 0x14; 
break; 
I 
}; 
Listing 1.167: Optimizing GCC 5.4.0 x86 
.LC0: 
.string "IF=%d KHz is not supportted, 3250 assumed\n" 
qa 
sub esp, 12 
mov eax, DWORD PTR [esp+16] 
cmp eax, 4000 
je .L3 
jg .L4 
cmp eax, 3250 
je .L5 
cmp eax, 3500 
jne .L2 
mov BYTE PTR ncol, 56 
mov BYTE PTR nco2, 0 
add esp, 12 
ret 
.L4: 
cmp eax, 5000 
je .L7 
cmp eax, 5380 
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jne .L2 
mov BYTE PTR ncol, 86 
mov BYTE PTR nco2, 20 
add esp, 12 
ret 

.L2: 
sub esp, 8 
push eax 
push OFFSET FLAT:.LCO 
call printf 
add esp, 16 

«L5: 
mov BYTE PTR ncol, 52 
mov BYTE PTR nco2, 0 
add esp, 12 
ret 

.L3: 
mov BYTE PTR ncol, 64 
mov BYTE PTR nco2, 0 
add esp, 12 
ret 

.L7: 
mov BYTE PTR ncol, 80 
mov BYTE PTR nco2, 0 
add esp, 12 
ret 


We can get to .L5 label if there is number 3250 at function’s input. But we can get 
to this label from the other side: we see that there are no jumps between printf () 
call and .L5 label. 


Now we can understand why switch() statement is sometimes a source of bugs: one 
forgotten break will transform your switch() statement into fallthrough one, and sev- 
eral blocks will be executed instead of single one. 


1.21.5 Exercises 
Exercise#1 


It’s possible to rework the C example in 1.21.2 on page 210 in such way that the 
compiler can produce even smaller code, but will work just the same. Try to achieve 
it. 


1.22 Loops 


1.22.1 Simple example 
x86 


There is a special LOOP instruction in x86 instruction set for checking the value in 
register ECX and if it is not 0, to decrement ECX and pass control flow to the label 
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in the LOOP operand. Probably this instruction is not very convenient, and there are 
no any modern compilers which emit it automatically. So, if you see this instruction 
somewhere in code, it is most likely that this is a manually written piece of assembly 
code. 


In C/C++ loops are usually constructed using for(), while() or do/while() state- 
ments. 


Let's start with for(). 


This statement defines loop initialization (set loop counter to initial value), loop con- 
dition (is the counter bigger than a limit?), what is performed at each iteration (in- 
crement/decrement) and of course loop body. 


for (initialization; condition; at each iteration) 


{ 
I 


loop body; 


The generated code is consisting of four parts as well. 


Let's start with a simple example: 


#include <stdio.h> 


void printing function(int i) 


{ 
printf ("f(%d)\n", i); 
$; 
int main() 
1 
int i; 
for (i-2; i«10; i++) 
printing function(i); 
return 0; 
$; 


The result (MSVC 2010): 
Listing 1.168: MSVC 2010 


_ig = -4 
_Main PROC 
push ebp 
mov ebp, esp 
push ecx 
mov DWORD PTR i$[ebp], 2 ; loop initialization 
jmp SHORT $LN3@main 
$LN2@main: 
mov eax, DWORD PTR i$[ebp] ; here is what we do after each iteration: 
add eax, 1 ; add 1 to (i) value 


mov DWORD PTR i$[ebp], eax 
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$LN3@main: 
cmp DWORD PTR i$[ebp], 10 
iteration 
jge SHORT $LN1@main 
finish loop 
mov ecx, DWORD PTR i$[ebp] 
push ecx 
call printing function 
add esp, 4 
jmp SHORT $LN2@main 
$LN1@main: 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 
_Main ENDP 


; this condition is checked before each 


; if (1) is biggest or equals to 10, lets 


; loop body: call printing function(i) 


; jump to loop begin 
; loop end 


As we see, nothing special. 


GCC 4.4.1 emits almost the same code, with one subtle difference: 


Listing 1.169: GCC 4.4.1 


main proc near 
var 20 = dword ptr -20h 
var 4 - dword ptr -4 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 20h 
mov [esp+20h+var 4], 2 ; (i) initializing 


increment 


; (1) 


; if i«-9, continue loop 


jmp short loc 8048476 
loc 8048465: 
mov eax, [esp+20h+var 4] 
mov [esp+20h+var_20], eax 
call printing function 
add [esp+20h+var 4], 1 
loc 8048476: 
cmp [esp+20h+var 4], 9 
jte short loc 8048465 
mov eax, 0 
leave 
retn 
main endp 


Now let's see what we get with optimization turned on (/0x): 


Listing 1.170: Optimizing MSVC 


PROC 
esi 


main 
push 
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mov esi, 2 
$LL3@main: 
push esi 
call printing function 
inc esi 
add esp, 4 
cmp esi, 10 ; 0000000aH 
jl SHORT $LL3@main 
xor eax, eax 
pop esi 
ret 0 
main ENDP 


What happens here is that space for the ; variable is not allocated in the local stack 
anymore, but uses an individual register for it, ESI. This is possible in such small 
functions where there aren't many local variables. 


One very important thing is that the f () function must not change the value in ESI. 
Our compiler is sure here. And if the compiler decides to use the ESI register in f () 
too, its value would have to be saved at the function's prologue and restored at the 
function's epilogue, almost like in our listing: please note PUSH ESI/POP ESIatthe 
function start and end. 


Let's try GCC 4.4.1 with maximal optimization turned on (-03 option): 
Listing 1.171: Optimizing GCC 4.4.1 


main proc near 

var 10 - dword ptr -10h 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 10h 
mov [esp-10h-var 10], 2 
call printing function 
mov [esp+10h+var_ 10], 3 
call printing function 
mov [esp+10h+var 10], 4 
call printing function 
mov [esp+10h+var_ 10], 5 
call printing function 
mov [esp+10h+var_10], 6 
call printing function 
mov [esp+10h+var_10], 7 
call printing function 
mov [esp+10h+var_10], 8 
call printing function 
mov [esp+10h+var_10], 9 
call printing function 
xor eax, eax 
leave 
retn 
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main endp 


Huh, GCC just unwound our loop. 


Loop unwinding has an advantage in the cases when there aren't much iterations 
and we could cut some execution time by removing all loop support instructions. On 
the other side, the resulting code is obviously larger. 


Big unrolled loops are not recommended in modern times, because bigger functions 
may require bigger cache footprint!?!. 


OK, let's increase the maximum value of the ; variable to 100 and try again. GCC 
does: 


Listing 1.172: GCC 


public main 


main proc near 

var 20 - dword ptr -20h 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
push ebx 
mov ebx, 2 ; i=2 
sub esp, 1Ch 


; aligning label loc 80484D0 (loop body begin) by 16-byte border: 
nop 


loc 80484D0: 
; pass (i) as first argument to printing function(): 


mov [esp*-20h-var 20], ebx 
add ebx, 1 ; i++ 
call printing_function 
cmp ebx, 64h ; i==100? 
jnz short loc_80484D0 ; if not, continue 
add esp, 1Ch 
xor eax, eax ; return 0 
pop ebx 
mov esp, ebp 
pop ebp 
retn 

main endp 


It is quite similar to what MSVC 2010 with optimization (/0x) produce, with the ex- 
ception that the EBX register is allocated for the i variable. 


GCC is sure this register will not be modified inside of the f() function, and if it will, 
it will be saved at the function prologue and restored at epilogue, just like here in 


1014 very good article about it: [Ulrich Drepper, What Every Programmer Should Know About Memory, 
(2007)]102. Another recommendations about loop unrolling from Intel are here: [Intel& 64 and IA-32 
Architectures Optimization Reference Manual, (2014)3.4.1.7]. 
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the main() function. 
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x86: OllyDbg 


Let's compile our example in MSVC 2010 with /0x and /0b0 options and load it into 
OllyDbg. 


It seems that OllyDbg is able to detect simple loops and show them in square brack- 
ets, for convenience: 


ain thread, module loops 2 


Registers (FPU) 
003128A8 
GARDER. OFFSET ME 
6 PUSH_ESI 

2000000 [MOV ESI,2 ne 

PUSH ESI ae24rDss 

D4FFFFFF || CALL loops_2. 00331000 cene 
ADD ESP,4 88333378 loops 2 
CMP ESI,8R EIP 00331820 lo 

JL SHORT loops_2.00331026 2 
ZOR EAX, EAX - 
POP ESI 5 
RETN 
PUSH loops_2. 00331406 


DO Do 


Figure 1.54: OllyDbg: main() begin 


By tracing (F8 — step over) we see ESI incrementing. Here, for instance, ESI — i — 6: 


INT 
E PUSH ESI 
a20e0000 | MOU ESI,2 
PUSH ESI 
D4FFFFFF CALL Loops 2.88331888 
INC ESI 


DE 
DOD 


a loops. 
6633162D loops, 


ADD ESP,4 

CMP ESI,8R 

JL SHORT loops_2. 00331026 
XOR EAX, EAX 

POP ESI 


coco cc 


DODO-D Dean Dus 


PUSH loops_2. 00331406 


Figure 1.55: OllyDbg: loop body just executed with i = 6 


9 is the last loop value. That's why JL is not triggering after the increment, and the 
function will finish: 
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CPU - main thread, module loops 2 


6 
02000000 


H ESI 

D4FFFFFF CALL loops_2. 00331000 

INC ESI 

ADD ESP, 4 

CNP ESI, 6A 

JL SHORT loops_2. 00331026 
XOR EAX, EAX 
POP ESI 
RETN 
PUSH loops_2. 00331406 


- SE T. 3 : 
EA aaan T O GS 0028 fbit 
0 8 LastErr ERROR 


Figure 1.56: OllyDbg: ESI — 10, loop end 


x86: tracer 


As we might see, it is not very convenient to trace manually in the debugger. That's 
a reason we will try tracer. 


We open compiled example in IDA, find the address of the instruction PUSH ESI 
(passing the sole argument to f()), which is 0x401026 for this case and we run 
the tracer: 


tracer.exe -l:loops 2.exe bpx=loops_2.exe!0x00401026 


BPX just sets a breakpoint at the address and tracer will then print the state of the 
registers. 


In the tracer. log, this is what we see: 


PID-12884|New process loops 2.exe 

(0) loops 2.exe!0x401026 

EAX=0x00a328c8 EBX=0x00000000 ECX=0x6f0f4714 EDX=0x00000000 
ESI=0x00000002 EDI=0x00333378 EBP=0x0024fbfc ESP=0x0024fbb8 
EIP-0x00331026 

FLAGS-PF ZF IF 

(0) loops 2.exe!0x401026 

EAX=0x00000005 EBX-0x00000000 ECX=0x6f0a5617 EDX=0x000ee188 
ESI-0x00000003 EDI-0x00333378 EBP=0x0024fbfc ESP=0x0024fbb8 
EIP-0x00331026 

FLAGS=CF PF AF SF IF 

(0) loops 2.exe!0x401026 

EAX=0x00000005 EBX=0x00000000 ECX=0x6f0a5617 EDX=0x000ee188 
ESI-0x00000004 EDI=0x00333378 EBP=0x0024fbfc ESP-0x0024fbb8 
EIP=0x00331026 

FLAGS=CF PF AF SF IF 

(0) loops 2.exe!0x401026 

EAX=0x00000005 EBX=0x00000000 ECX=0x6f0a5617 EDX=0x000ee188 
ESI=0x00000005 EDI-0x00333378 EBP=0x0024fbfc ESP=0x0024fbb8 
EIP-0x00331026 
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FLAGS-CF AF SF IF 

(0) loops 2.exe!0x401026 
EAX=0x00000005 EBX=0x00000000 
ESI-0x00000006 EDI=0x00333378 
EIP=0x00331026 

FLAGS=CF PF AF SF IF 

(0) loops 2.exe!0x401026 
EAX=0x00000005 EBX=0x00000000 
ESI-0x00000007 EDI=0x00333378 
EIP=0x00331026 

FLAGS=CF AF SF IF 

(0) loops 2.exe!0x401026 
EAX=0x00000005 EBX=0x00000000 
ESI-0x00000008 EDI=0x00333378 
EIP=0x00331026 

FLAGS=CF AF SF IF 

(0) loops 2.exe!0x401026 
EAX=0x00000005 EBX=0x00000000 
ESI-0x00000009 EDI=0x00333378 
EIP=0x00331026 

FLAGS=CF PF AF SF IF 


ECX=0x6f0a5617 
EBP=0x0024fbfc 


ECX=0x6f0a5617 
EBP=0x0024fbfc 


ECX=0x6f0a5617 
EBP=0x0024fbfc 


ECX=0x6f0a5617 
EBP=0x0024fbfc 


EDX=0x000ee188 
ESP=0x0024fbb8 


EDX=0x000ee188 
ESP=0x0024 fbb8 


EDX=0x000ee188 
ESP=0x0024fbb8 


EDX=0x000ee188 
ESP=0x0024fbb8 


PID=12884|Process loops 2.exe exited. ExitCode=0 (0x0) 


We see how the value of ESI register changes from 2 to 9. 


Even more than that, the tracer can collect register values for all addresses within 
the function. This is called trace there. Every instruction gets traced, all interesting 
register values are recorded. 


Then, an IDA.idc-script is generated, that adds comments. So, in the IDA we've 
learned that the main() function address is 0x00401020 and we run: 


tracer.exe -l:loops 2.exe bpf=loops_2.exe!0x00401020,trace:cc 


BPF stands for set breakpoint on function. 


As a result, we get the loops 2.exe.idc and loops 2.exe clear.idc scripts. 
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We load loops 2.exe.idc into IDA and see: 


.text: 
.text: 
.text: 
.text: 
-text: 
«text: 
«text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


66461621 
90401026 


00401026 loc_401026: 


00401026 
00401027 
00401020 
80409182D 
66461636 
66461633 
66461635 
66461637 
66401638 
66401638 


.nain 


_cdecl main(int argc, const char **argu, const char **enup) 


proc near ; CODE XREF: ___tmainCRTStartup+11DJp 
= dword ptr 4 
= dword ptr 8 
= dword ptr  8Ch 
push esi ; ESI=1 
mou esi, 2 
; CODE XREF: _main+13/j 
push esi ; ESI-2..9 
call sub 401888 H tracing nested maximum leuel (1) reached, 
inc esi ; ESI-2..9 
add esp, 4 ; ESP-8x38fcbc 
cmp esi, 86h ; ESI-3..8xa 
ji short loc 401826 ; SF-false,true OF=false 
xor eax, eax 
pop esi 
retn ; EAX=0 
endp 


Figure 1.57: IDA with .idc-script loaded 


We see that ESI can be from 2 to 9 at the start of the loop body, but from 3 to OxA 
(10) after the increment. We can also see that main() is finishing with O in EAX. 


tracer also generates loops 2.exe.txt, that contains information about how many 
times each instruction has been executed and register values: 


Listing 1.173: loops 2.exe.txt 


1 [PUSH ESI] ESI-1 

1 [MOV ESI, 2] 

8 [PUSH ESI] ESI-2..9 

8 [CALL 8D1000h] tracing nested maximum 2 


(1) reached, skipping this CALL 8D1000h-0x8d1000 


0x401020 (.text+0x20), e= 
0x401021 (.text+0x21), e= 
0x401026 (.text+0x26), e= 
0x401027 (.text+0x27), e= 
VS level 
0x40102c (.text+0x2c), e= 
0x40102d (.text+0x2d), e= 
0x401030 (.text+0x30), e= 
0x401033 (.text+0x33), e= 
0x401035 (.text+0x35), e= 
0x401037 (.text+0x37), e= 
0x401038 (.text+0x38), e= 


[INC ESI] ESI=2..9 

[ADD ESP, 4] ESP=0x38fcbc 

[CMP ESI, 0Ah] ESI=3..0xa 

[JL 8D1026h] SF=false,true OF=false 
[XOR EAX, EAX] 

[POP EST] 

[RETN] EAX=0 


m F3 Fr CO œ CO CO 


We can use grep here. 


ARM 


Non-optimizing Keil 6/2013 (ARM mode) 
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main 
STMFD SP!, {R4,LR} 
MOV RA, #2 
B loc 368 
loc 35C ; CODE XREF: main+1C 
MOV RO, R4 
BL printing function 
ADD RA, R4, #1 
loc 368 ; CODE XREF: main+8 
CMP R4, #0xA 
BLT loc 35C 
MOV RO, #0 


LDMFD SP!, {R4,PC} 


Iteration counter i is to be stored in the R4 register. The MOV R4, #2 instruction just 
initializes i. The MOV RO, R4 and BL printing function instructions compose the 
body of the loop, the first instruction preparing the argument for f() function and 
the second calling the function. The ADD R4, R4, #1 instruction just adds 1 to the 
i variable at each iteration. CMP R4, £Z0xA compares i with OxA (10). The next 
instruction BLT (Branch Less Than) jumps if i is less than 10. Otherwise, 0 is to be 


written into RO (since our function returns 0) and function execution finishes. 


Optimizing Keil 6/2013 (Thumb mode) 


main 
PUSH {R4,LR} 
MOVS R4, #2 
loc 132 ; CODE XREF: 
MOVS RO, R4 
BL printing function 
ADDS R4, R4, #1 
CMP R4, #0xA 
BLT loc 132 
MOVS RO, #0 
POP {R4,PC} 


main+E 


Practically the same. 


Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


main 
PUSH {R4,R7,LR} 
MOVW RA, #0x1124 ; "sdin" 
MOVS R1, #2 
MOVT .W R4, #0 
ADD R7, SP, #4 
ADD R4, PC 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


242 


MOV RO, R4 
BLX | printf 
MOV RO, R4 
MOVS R1, 43 
BLX | printf 
MOV RO, R4 
MOVS R1, 44 
BLX | printf 
MOV RO, R4 
MOVS R1, #5 
BLX | printf 
MOV RO, R4 
MOVS R1, #6 
BLX | printf 
MOV RO, R4 
MOVS R1, 47 
BLX | printf 
MOV RO, R4 
MOVS R1, 48 
BLX | printf 
MOV RO, R4 
MOVS R1, 49 
BLX | printf 
MOVS RO, #0 
POP (RA, R7,PC]) 


In fact, this was in my f () function: 


void printing function(int i) 


1 
ur 


printf ("%d\n", i); 


So, LLVM not just unrolled the loop, but also inlined my very simple function f (), and 
inserted its body 8 times instead of calling it. 


This is possible when the function is so simple (like mine) and when it is not called 
too much (like here). 


ARM64: Optimizing GCC 4.9.1 


Listing 1.174: Optimizing GCC 4.9.1 


printing function: 

; prepare second argument of printf(): 
mov wl, wO 

; load address of the "f(%d)\n" string 
adrp x0, .LCO 


add x0, x0, :1012:.LC0 
; just branch here instead of branch with link and return: 
b printf 


main: 
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save FP and LR in the local stack: 


stp x29, x30, [sp, -32]! 

; set up stack frame: 
add x29, sp, 0 

; save contents of X19 register in the local stack: 
str x19, [sp,16] 


; we will use W19 register as counter. 
set initial value of 2 to it: 


mov w19, 2 
.L3: 
; prepare first argument of printing function(): 
mov w0, w19 
; increment counter register. 
add w19, w19, 1 
; WO here still holds value of counter value before increment. 
bl printing function 
; is it end? 
cmp w19, 10 
; no, jump to the loop body begin: 
bne .L3 
; return 0 
mov w0, 0 


restore contents of X19 register: 
ldr x19, [sp,16] 
restore FP and LR values: 
ldp x29, x30, [sp], 32 
ret 


.LC0: 
.string "f(%d)\n" 


ARM64: Non-optimizing GCC 4.9.1 


Listing 1.175: Non-optimizing GCC 4.9.1 -fno-inline 


.LC0: 
.string "f(%d)\n" 
printing function: 
; save FP and LR in the local stack: 


stp x29, x30, [sp, -32]! 
; set up stack frame: 

add x29, sp, 0 
; save contents of WO register: 

str w0, [x29,28] 


; load address of the "f(%d)\n" string 
adrp x0, .LCO 
add x0, x0, :1012:.LC0 

; reload input value from the local stack to W1 register: 
ldr wl, [x29,28] 

; call printf() 


bl printf 
; restore FP and LR values: 
ldp x29, x30, [sp], 32 
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ret 
main: 
; save FP and LR in the local stack: 
stp x29, x30, [sp, -32]! 
; set up stack frame: 
add x29, sp, 0 
; initialize counter 
mov w0, 2 


; Store it to the place allocated for it in the local stack: 
str w0, [x29,28] 

; Skip loop body and jump to the loop condition check instructions: 
b .L3 


.L4: 
; load counter value to WO. 
; it will be the first argument of printing function(): 
ldr w0, [x29,28] 
; call printing function(): 
bl printing function 
; increment counter value: 
ldr w0, [x29,28] 
add w0, w0, 1 
str w0, [x29,28] 
.L3: 
; loop condition check. 
; load counter value: 
ldr w0, [x29,28] 
; is it 9? 
cmp w0, 9 
; less or equal? then jump to loop body begin: 
; do nothing otherwise. 


ble .L4 
; return 0 
mov w0, 0 
; restore FP and LR values: 
ldp x29, x30, [sp], 32 
ret 


MIPS 


Listing 1.176: Non-optimizing GCC 4.4.5 (IDA) 


main: 


; IDA is not aware of variable names in local stack 
; We gave them names manually: 


i = -0x10 
saved FP = -8 
saved RA = -4 


; function prologue: 
addiu  $sp, -0x28 
sw $ra, 0x28+saved_RA($sp) 
SW $fp, Ox28+saved FP($sp) 
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move $fp, $sp 
; initialize counter at 2 and store this value in local stack 


li $v0, 2 

Sw $v0, 0x28+1($fp) 
; pseudoinstruction. "BEQ $ZERO, $ZERO, loc 9C" there in fact: 

b loc 9C 

or $at, $zero ; branch delay slot, NOP 
loc 80: # CODE XREF: main+48 
; load counter value from local stack and call printing function(): 

lw $a0, 0x28+1($fp) 

jal printing function 

or $at, $zero ; branch delay slot, NOP 
; load counter, increment it, store it back: 

lw $v0, 0x28+1($fp) 

or $at, $zero ; NOP 

addiu $v0, 1 

SW $vO, Ox28+i($fp) 
loc 9C: # CODE XREF: main+18 
; check counter, is it 10? 

lw $v0, 0x28+1($fp) 

or $at, $zero ; NOP 


slti $v0, OxA 
; if it is less than 10, jump to loc 80 (loop body begin): 
bnez $v0, loc 80 


or $at, $zero ; branch delay slot, NOP 
; finishing, return 0: 
move $v0, $zero 


; function epilogue: 
move $sp, $fp 


lw $ra, 0x28+saved_RA($sp) 

lw $fp, Ox28+saved FP($sp) 

addiu  $sp, 0x28 

jr $ra 

or gat, $zero ; branch delay slot, NOP 


The instruction that’s new to us is B. It is actually the pseudo instruction (BEQ). 


One more thing 


In the generated code we can see: after initializing 7, the body of the loop is not to 
be executed, as the condition for i is checked first, and only after that loop body can 
be executed. And that is correct. 


Because, if the loop condition is not met at the beginning, the body of the loop must 
not be executed. This is possible in the following case: 


for (i=0; i<total_entries to process; i++) 
loop body; 


If total entries to process is 0, the body of the loop must not be executed at all. 
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This is why the condition checked before the execution. 


However, an optimizing compiler may swap the condition check and loop body, if 
it sure that the situation described here is not possible (like in the case of our very 
simple example and using compilers like Keil, Xcode (LIVM), MSVC in optimization 
mode). 


1.22.2 Memory blocks copying routine 


Real-world memory copy routines may copy 4 or 8 bytes at each iteration, use 
SIMD!??, vectorization, etc. But for the sake of simplicity, this example is the sim- 
plest possible. 


#include <stdio.h> 


void my memcpy (unsigned char* dst, unsigned char* src, size t cnt) 
1 
size t i; 
for (i20; i«cnt; i++) 
dst[i]ssrc[i]; 
}; 


Straight-forward implementation 


Listing 1.177: GCC 4.9 x64 optimized for size (-Os) 


my memcpy: 

; RDI = destination address 
; RSI 
; RDX 


source address 
size of block 


; initialize counter (i) at 0 


xor eax, eax 
.L2: 
; all bytes copied? exit then: 
cmp rax, rdx 
je .L5 
; load byte at RSI+i: 
mov cl, BYTE PTR [rsi+rax] 
; store byte at RDI+i: 
mov BYTE PTR [rdi+rax], cl 
inc rax ; i++ 
jmp .L2 
¿15% 
ret 
Listing 1.178: GCC 4.9 ARM64 optimized for size (-Os) 
my memcpy: 


; X0 = destination address 


103Single Instruction, Multiple Data 
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; X1 = source address 

; X2 = size of block 

; initialize counter (i) at 0 
mov x3, 0 

.L2: 

; all bytes copied? exit then: 
cmp x3, x2 
beq .L5 


; load byte at X1+i: 

ldrb w4, [x1,x3] 
; store byte at X0+i: 

strb w4, [x0,x3] 


add x3, x3, 1 ; i++ 
b .L2 

.L5: 
ret 


Listing 1.179: Optimizing Keil 6/2013 (Thumb mode) 


my memcpy PROC 
; RO = destination address 


z 
E 
uH I! 


source address 
; R2 = size of block 
PUSH {r4, lr} 
; initialize counter (i) at 0 
MOVS r3,*0 
; condition checked at the end of function, so jump there: 
B [L0.12| 
[L0.6| 
; load byte at Rl+i: 
LDRB rA, [r1,r3] 
; store byte at RO+i: 
STRB r4,[r0,r3] 
; lt 
ADDS r3,r3,#1 
[L0.12| 
; i<size? 
CMP r3,r2 
; jump to the loop begin if its so: 
BCC [L0.6| 
POP {r4,pc} 
ENDP 


ARM in ARM mode 
Keil in ARM mode takes full advantage of conditional suffixes: 


Listing 1.180: Optimizing Keil 6/2013 (ARM mode) 


my memcpy PROC 
; RO = destination address 
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; R1 = source address 

; R2 = size of block 

; initialize counter (i) at 0 
MOV r3,*0 

[L0.4| 

; all bytes copied? 
CMP r3,r2 


; the following block is executed only if less than condition, 
; i.e., if R2«R3 or i<size. 
load byte at Rl+i: 
LDRBCC r12,[r1,r3] 
store byte at RO+i: 
STRBCC r12,[r0,r3] 


; i++ 
ADDCC r3,r3,#1 
the last instruction of the conditional block. 
jump to loop begin if i<size 
; do nothing otherwise (i.e., if i>=size) 


BCC |L0.4] 
; return 

BX lr 

ENDP 


That's why there is only one branch instruction instead of 2. 


MIPS 

Listing 1.181: GCC 4.4.5 optimized for size (-Os) (IDA) 
my memcpy: 
; jump to loop check part: 


b loc 14 
; initialize counter (i) at 0 
; it will always reside in $v0: 
move $v0, $zero ; branch delay slot 


loc 8: + CODE XREF: my memcpy-1C 
; load byte as unsigned at address in $t0 to $vl: 
lbu $v1, 0($t0) 
; increment counter (i): 
addiu $v0, 1 
; store byte at $a3 
sb $v1, 0($a3) 


loc 14: # CODE XREF: my memcpy 
; check if counter (i) in $v0 is still less then 3rd function argument ("cnt" 
in $a2): 
sltu $v1, $vO, $a2 
; form address of byte in source block: 
addu $t0, $al, $v0 
; $tO = $al+$v0 = srcti 
; Jump to loop body if counter sill less then "cnt": 
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bnez $v1, loc 8 
; form address of byte in destination block ($a3 = $a0+$v0 = dst+i): 
addu $a3, $a0, $v0 ; branch delay slot 
; finish if BNEZ wasnt triggered: 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


Here we have two new instructions: LBU ("Load Byte Unsigned") and SB ("Store 
Byte"). 


Just like in ARM, all MIPS registers are 32-bit wide, there are no byte-wide parts like 
in x86. 


So when dealing with single bytes, we have to allocate whole 32-bit registers for 
them. 


LBU loads a byte and clears all other bits ("Unsigned"). 


On the other hand, LB ("Load Byte") instruction sign-extends the loaded byte to a 
32-bit value. 


SB just writes a byte from lowest 8 bits of register to memory. 


Vectorization 


Optimizing GCC can do much more on this example: 1.36.1 on page 522. 


1.22.3 Condition check 


It’s important to keep in mind that in for() construct, condition is checked not at 
the end, but at the beginning, before execution of loop body. But often, it's more 
convenient for compiler to check it at the end, after body. Sometimes, additional 
check can be appended at the beginning. 


For example: 


#include <stdio.h> 


void f(int start, int finish) 
{ 
for (; start<finish; start++) 
printf ("%d\n", start); 
yi 


Optimizing GCC 5.4.0 x64: 


f: 

; check condition (1): 
cmp edi, esi 
jge .L9 
push rbp 
push rbx 
mov ebp, esi 
mov ebx, edi 
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sub rsp, 8 
.L5: 
mov edx, ebx 
xor eax, eax 
mov esi, OFFSET FLAT:.LCO ; "%d\n" 
mov edi, 1 
add ebx, 1 
call . printf chk 
; check condition (2): 
cmp ebp, ebx 
jne .L5 
add rsp, 8 
pop rbx 
pop rbp 
.L9: 
rep ret 


We see two checks. 


Hex-Rays (at least version 2.2.0) decompiles this as: 


void cdecl f(unsigned int start, unsigned int finish) 


1 
unsigned int v2; // ebx@2 
. int64 v3; // rdx@3 


if ( (signed int)start « (signed int)finish ) 


1 
v2 = start; 
do 
{ 
v3 = V2++; 
_printf_chk(1LL, "%d\n", v3); 
while ( finish != v2 ); 
} 


In this case, do/while() can be replaced by for() without any doubt, and the first check 
can be removed. 

1.22.4 Conclusion 

Rough skeleton of loop from 2 to 9 inclusive: 


Listing 1.182: x86 


mov [counter], 2 ; initialization 
jmp check 
body: 
; loop body 
; do something here 
; use counter variable in local stack 
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add [counter], 1 ; increment 
check: 

cmp [counter], 9 

jte body 


The increment operation may be represented as 3 instructions in non-optimized 
code: 


Listing 1.183: x86 


MOV [counter], 2 ; initialization 
JMP check 
body: 
; loop body 
; do something here 
; use counter variable in local stack 
MOV REG, [counter] ; increment 


INC REG 

MOV [counter], REG 
check: 

CMP [counter], 9 

JLE body 


If the body of the loop is short, a whole register can be dedicated to the counter 
variable: 


Listing 1.184: x86 


MOV EBX, 2 ; initialization 
JMP check 
body: 
; loop body 
; do something here 
; use counter in EBX, but do not modify it! 
INC EBX ; increment 
check: 
CMP EBX, 9 
JLE body 


Some parts of the loop may be generated by compiler in different order: 


Listing 1.185: x86 


MOV [counter], 2 ; initialization 
JMP label check 
label increment: 
ADD [counter], 1 ; increment 
label check: 
CMP [counter], 10 
JGE exit 
; loop body 
; do something here 
; use counter variable in local stack 
JMP label increment 
exit: 
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Usually the condition is checked before loop body, but the compiler may rearrange 
it in a way that the condition is checked after loop body. 


This is done when the compiler is sure that the condition is always true on the first 
iteration, so the body of the loop is to be executed at least once: 


Listing 1.186: x86 


MOV REG, 2 ; initialization 
body: 
; loop body 
; do something here 
; use counter in REG, but do not modify it! 
INC REG ; increment 
CMP REG, 10 
JL body 


Using the LOOP instruction. This is rare, compilers are not using it. When you see it, 
it’s a sign that this piece of code is hand-written: 


Listing 1.187: x86 


; count from 10 to 1 
MOV ECX, 10 
body: 
; loop body 
; do something here 
; use counter in ECX, but do not modify it! 
LOOP body 


ARM. 
The R4 register is dedicated to counter variable in this example: 
Listing 1.188: ARM 


MOV R4, 2 ; initialization 
B check 
body: 
; loop body 
; do something here 
; use counter in R4, but do not modify it! 
ADD R4,R4, #1 ; increment 
check: 
CMP R4, #10 
BLT body 


1.22.5 Exercises 
* http://challenges.re/54 
* http://challenges.re/55 
* http://challenges.re/56 
* http://challenges.re/57 
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1.23 More about strings 


1.23.1 strlen() 


Let's talk about loops one more time. Often, the strlen() function +% is imple- 
mented using a while() statement. Here is how it is done in the MSVC standard 
libraries: 


int my strlen (const char * str) 


1 
const char *eos = str; 
while( *eos++ ) ; 
return( eos - str - 1 ); 
} 
int main() 
{ 
// test 
return my_strlen("hello!"); 
F 
x86 


Non-optimizing MSVC 


Let's compile: 


| eos$ = -4 ; size = 4 
_str$ = 8 ; size = 4 
_strlen PROC 
push ebp 
mov ebp, esp 
push ecx 
mov eax, DWORD PTR str$[ebp] ; place pointer to string from "str" 
mov DWORD PTR _eos$[ebp], eax ; place it to local variable "eos" 
$LN2Gstrlen : 
mov ecx, DWORD PTR eos$[ebp] ; ECX-eos 


; take 8-bit byte from address in ECX and place it 
; aS 32-bit value to EDX with sign extension 


movsx edx, BYTE PTR [ecx] 


mov eax, DWORD PTR eos$[ebp] ; EAX=eos 

add eax, 1 ; increment EAX 

mov DWORD PTR _eos$[ebp], eax ; place EAX back to "eos" 
test edx, edx ; EDX is zero? 

je SHORT $LN1@strlen_ ; yes, then finish loop 
jmp SHORT $LN2@strlen_ ; continue loop 


104 counting the characters in a string in the C language 
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$LN1@strlen_: 
; here we calculate the difference between two pointers 


mov eax, DWORD PTR _eos$[ebp] 
sub eax, DWORD PTR _str$[ebp] 


sub eax, 1 ; subtract 1 and return result 
mov esp, ebp 

pop ebp 

ret 0 


_strlen_ ENDP 


We get two new instructions here: MOVSX and TEST. 


The first one—MOVSX—takes a byte from an address in memory and stores the value 
in a 32-bit register. MOVSX stands for MOV with Sign-Extend. MOVSX sets the rest of 
the bits, from the 8th to the 31th, to 1 if the source byte is negative or to O if is 
positive. 


And here is why. 


By default, the char type is signed in MSVC and GCC. If we have two values of 
which one is char and the other is int, (int is signed too), and if the first value con- 
tain -2 (coded as OxFE) and we just copy this byte into the int container, it makes 
0x000000FE, and this from the point of signed int view is 254, but not -2. In signed 
int, -2 is coded as OxFFFFFFFE. So if we have to transfer OxFE from a variable of char 
type to int, we have to identify its sign and extend it. That is what MOVSX does. 


It's hard to say if the compiler needs to store a char variable in EDX, it could just take 
a 8-bit register part (for example DL). Apparently, the compiler's register allocator 
works like that. 


Then we see TEST EDX, EDX. You can read more about the TEST instruction in the 
section about bit fields (1.28 on page 382). Here this instruction just checks if the 
value in EDX equals to 0. 


Non-optimizing GCC 


Let's try GCC 4.4.1: 


public strlen 


strlen proc near 
eos = dword ptr -4 
arg 0 = dword ptr 8 
push ebp 
mov ebp, esp 
sub esp, 10h 
mov eax, [ebp«arg 0] 
mov [ebp+eos], eax 


loc 80483F0: 
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mov eax, [ebp+eos] 
movzx eax, byte ptr [eax] 
test al, al 
setnz al 
add [ebpteos], 1 
test al, al 
jnz short loc 80483F0 
mov edx, [ebp+eos] 
mov eax, [ebp«arg 0] 
mov ecx, edx 
sub ecx, eax 
mov eax, ecx 
sub eax, 1 
leave 
retn 

strlen endp 


The result is almost the same as in MSVC, but here we see MOVZX instead of MOVSX. 
MOVZX stands for MOV with Zero-Extend. This instruction copies a 8-bit or 16-bit 
value into a 32-bit register and sets the rest of the bits to O. In fact, this instruction 
is convenient only because it enable us to replace this instruction pair: 

xor eax, eax / mov al, [...]. 


On the other hand, it is obvious that the compiler could produce this code: 

mov al, byte ptr [eax] / test al, al—itis almostthe same, however, the high- 
est bits of the EAX register will contain random noise. But let's think it is compiler's 
drawback—it cannot produce more understandable code. Strictly speaking, the com- 
piler is not obliged to emit understandable (to humans) code at all. 


The next new instruction for us is SETNZ. Here, if AL doesn't contain zero, test al, 
al sets the ZF flag to 0, but SETNZ, if ZF==0 (NZ stands for not zero) sets AL to 
1. Speaking in natural language, if AL is not zero, let's jump to loc 80483F0. The 
compiler emits some redundant code, but let's not forget that the optimizations are 
turned off. 


Optimizing MSVC 


Now let's compile all this in MSVC 2012, with optimizations turned on (/0x): 
Listing 1.189: Optimizing MSVC 2012 /ObO 


_str$ = 8 ; size = 4 
_strlen PROC 
mov edx, DWORD PTR str$[esp-4] ; EDX -> pointer to the string 
mov eax, edx ; move to EAX 
$LL2@strlen: 
mov cl, BYTE PTR [eax] ; CL = *EAX 
inc eax ; EAX++ 
test cl, cl ; CL==0? 
jne SHORT $LL2@strlen ; no, continue loop 
sub eax, edx ; calculate pointers difference 
dec eax ; decrement EAX 
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ret 0 
_strlen ENDP 


Now it is all simpler. Needless to say, the compiler could use registers with such 
efficiency only in small functions with a few local variables. 

INC/DEC—are increment/decrement instructions, in other words: add or subtract 1 
to/from a variable. 
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Optimizing MSVC + OllyDbg 


We can try this (optimized) example in OllyDbg. Here is the first iteration: 


CPU - main thread, module ex1 lolx] 
> i ^ 


MOU EDX,DWORD PTR : CARG. 11 
MOU EAX, EDX SCIT "hellor" 


| ! o SCII "hellot” 


' 41331006 
ES 002B 


it vEFDDaBatFFF) 
bit G(FFFFFFFF) 


813 
[61383006]=68 ('h') 
CL-ES 

Jump from 138188B 
Loop 61381666: loop variable EAX(+1) 


ETURN from . 
ASCII "hello" 
RETURN from ex1.@ 


Po Pointer to next Slip 


Figure 1.58: OllyDbg: first iteration start 


We see that OllyDbg found a loop and, for convenience, wrapped its instructions in 
brackets. By clicking the right button on EAX, we can choose “Follow in Dump” and 
the memory window scrolls to the right place. Here we can see the string “hello!” in 
memory. There is at least one zero byte after it and then random garbage. 


If OllyDbg sees a register with a valid address in it, that points to some string, it is 
shown as a string. 
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Let's press F8 (step over) a few times, to get to the start of the body of the loop: 


CPU - main thread, module ex1 


MOV EDX, DWORD PTR SS: CARG. 1] 
MOU EAX, EDX 
MOU CL,BYTE PTR DS: CEAXI 
INC_EAX 
TEST CL,CL 
JN2 SHORT 81381886 
SUB EAX, EDX 
DEC EAX 
RETI 
IN 
IN > 4 a 1006 


7 ; B(FFFFFFFF) 
t G(FFFFFFFF) 
; B(FFFFFFFF) 
FFFFFFFF) 

t PEFODG@G( FFF) 
t G(FFFFFFFF) 


"hellot" 


ID AONDIVO 


1, GE, G) 


ol B 
Loop 813818606: loop variable EAX(+1) 


aa 
44A46FEE 


to next Sly 


Figure 1.59: OllyDbg: second iteration start 


We see that EAX contains the address of the second character in the string. 
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We have to press F8 enough number of times in order to escape from the loop: 


CPU - main thread, module ex1 a] 


$ 8BS424 84 MOV EDX, DWORD PTR SS: [ARG. 1] 
. MOU EAX, EDX 
MOU CL,BYTE PTR DS:[EAX] 

C ERA 


L,CL 


JNZ SHORT 01381006 
SUB EAX, EDX 


DEC EAX” 
TRIS 
IN EIP 8138188D .8 Bap 
IN ca ES FFFFFFFF) 


IN 
FFFFFFFF) 


7EFOD@G0( FFF) 
BCFFFFFFFF) 


N from . 
11 "hellot” 
RETURN from ex1.8 


ointer to nest Sly 


Figure 1.60: OllyDbg: pointers difference to be calculated now 


We see that EAX now contains the address of zero byte that's right after the string 
plus 1 (because INC EAX was executed regardless of whether we exit from the loop 
or not). Meanwhile, EDX hasn't changed, so it still pointing to the start of the string. 


The difference between these two addresses is being calculated now. 
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The SUB instruction just got executed: 


CPU - main thread, module ex1 


$ BBeg24 04 [MOU EDX, DIORD PTR 95: CARS. 1] 
MOU EAX, ED 

MOY CL BYTE PTR DS: [EAK] 

[sE CL, CL hello 

JN SHORT 01381006 

SUB EAX, EDX 

DEC ERX 


) DAA 


B133100F 


@(FFFFFFFF) 
O(FFFFFFFF) 
G(FFFFFFFF) 
OLFFFFFFFF) 
TEFDDaaatFFF) 
OCFFFFFFFF) 


DOS: 


EFL 
MMO a 


; |Pointer to nest 


Figure 1.61: OllyDbg: EAX to be decremented now 


The difference of pointers is in the EAX register now—7. Indeed, the length of the 
"hello!" string is 6, but with the zero byte included—7. But strlen() must return 
the number of non-zero characters in the string. So the decrement executes and 
then the function returns. 


Optimizing GCC 


Let's check GCC 4.4.1 with optimizations turned on (-03 key): 


public strlen 


strlen proc near 
arg 0 - dword ptr 8 
push ebp 
mov ebp, esp 
mov ecx, [ebp«arg 0] 
mov eax, ecx 


loc 8048418: 
movzx edx, byte ptr [eax] 


add eax, 1 
test dl, dl 
jnz short loc 8048418 
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not ecx 
add eax, ecx 
pop ebp 
retn 
strlen endp 


Here GCC is almost the same as MSVC, except for the presence of MOVZX. However, 
here MOVZX could be replaced with 
mov dl, byte ptr [eax]. 


Perhaps it is simpler for GCC's code generator to remember the whole 32-bit EDX 
register is allocated for a char variable and it then can be sure that the highest bits 
has no any noise at any point. 


After that we also see a new instruction—NOT. This instruction inverts all bits in the 
operand. 

You can say that it is a synonym to the XOR ECX, Offffffffh instruction. NOT and 
the following ADD calculate the pointer difference and subtract 1, just in a different 
way. At the start ECX, where the pointer to str is stored, gets inverted and 1 is 
subtracted from it. 


In other words, at the end of the function just after loop body, these operations are 
executed: 


ecx=str; 
eax-eos; 
ecx=(-ecx)-1; 
eaX=eax+ecx 
return eax 


... and this is effectively equivalent to: 


ecx=str; 
eax-eos; 
eax-eax-ecx; 
eax=eax-1; 
return eax 


Why did GCC decide it would be better? Hard to guess. But perhaps the both variants 
are equivalent in efficiency. 


ARM 
32-bit ARM 


Non-optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Listing 1.190: Non-optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


_strlen 
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eos = 
str = -4 


SUB SP, SP, #8 ; allocate 8 bytes for local variables 
STR RO, [SP,#8+str] 
LDR RO, [SP,#8+str] 
STR RO, [SP,#8+e0s] 


loc 2CB8 ; CODE XREF: _strlen+28 
LDR RO, [SP,*8+eos] 
ADD R1, RO, #1 
STR R1, [SP,+8+eos] 
LDRSB RO, [RO] 
CMP RO, #0 
BEQ loc 2CD4 
B loc 2CB8 

loc 2CD4 ; CODE XREF: _strlen+24 
LDR RO, [SP,+t8+eos] 
LDR R1, [SP,#8+str] 
SUB RO, RO, R1 ; R0zeos-str 
SUB RO, RO, #1 ; RO=RO-1 
ADD SP, SP, #8 ; free allocated 8 bytes 


Non-optimizing LLVM generates too much code, however, here we can see how the 
function works with local variables in the stack. There are only two local variables 
in our function: eos and str. In this listing, generated by IDA, we have manually 
renamed var 8 and var 4 to eos and str. 


The first instructions just saves the input values into both str and eos. 
The body of the loop starts at label loc 2CB8. 


The first three instruction in the loop body (LDR, ADD, STR) load the value of eos into 
RO. Then the value is incremented and saved back into eos, which is located in the 
stack. 


The next instruction, LDRSB RO, [R0] ("Load Register Signed Byte"), loads a byte 
from memory at the address stored in RO and sign-extends it to 32-bit !05. This is 
similar to the MOVSX instruction in x86. 


The compiler treats this byte as signed since the char type is signed according to 
the C standard. It was already written about it (1.23.1 on page 254) in this section, 
in relation to x86. 


It has to be noted that it is impossible to use 8- or 16-bit part of a 32-bit register in 
ARM separately of the whole register, as it is in x86. 


Apparently, it is because x86 has a huge history of backwards compatibility with its 
ancestors up to the 16-bit 8086 and even 8-bit 8080, but ARM was developed from 
scratch as a 32-bit RISC-processor. 


105The Keil compiler treats the char type as signed, just like MSVC and GCC. 
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Consequently, in order to process separate bytes in ARM, one has to use 32-bit 
registers anyway. 


So, LDRSB loads bytes from the string into RO, one by one. The following CMP and 
BEQ instructions check if the loaded byte is O. If it's not 0, control passes to the start 
of the body of the loop. And if it's O, the loop ends. 


At the end of the function, the difference between eos and str is calculated, 1 is 
subtracted from it, and resulting value is returned via RO. 


N.B. Registers were not saved in this function. 


That's because in the ARM calling convention registers RO-R3 are "scratch registers", 
intended for arguments passing, and we're not required to restore their value when 
the function exits, since the calling function will not use them anymore. Conse- 
quently, they may be used for anything we want. 


No other registers are used here, so that is why we have nothing to save on the 
stack. 


Thus, control may be returned back to calling function by a simple jump (BX), to the 
address in the LR register. 


Optimizing Xcode 4.6.3 (LLVM) (Thumb mode) 


Listing 1.191: Optimizing Xcode 4.6.3 (LIVM) (Thumb mode) 


_strlen 
MOV R1, RO 
loc_2DF6 
LDRB.W R2, [R1],+1 
CMP R2, #0 
BNE loc 2DF6 
MVNS RO, RO 
ADD RO, R1 
BX LR 


As optimizing LLVM concludes, eos and str do not need space on the stack, and can 
always be stored in registers. 


Before the start of the loop body, str is always in RO, and eos—in R1. 


The LDRB.W R2, [R1],#1 instruction loads a byte from the memory at the address 
stored in R1, to R2, sign-extending it to a 32-bit value, but not just that. #1 at the 
instruction's end is implies "Post-indexed addressing", which means that 1 is to be 
added to R1 after the byte is loaded. Read more about it: 1.39.2 on page 555. 


Then you can see CMP and BNE? in the body of the loop, these instructions continue 
looping until O is found in the string. 


106 (PowerPC, ARM) Branch if Not Equal 
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MVNS??/ (inverts all bits, like NOT in x86) and ADD instructions compute eos - str - 1. In 
fact, these two instructions compute RO = str + eos, which is effectively equivalent 
to what was in the source code, and why it is so, was already explained here (1.23.1 
on page 261). 


Apparently, LLVM, just like GCC, concludes that this code can be shorter (or faster). 


Optimizing Keil 6/2013 (ARM mode) 


Listing 1.192: Optimizing Keil 6/2013 (ARM mode) 


_strlen 
MOV R1, RO 


loc 2C8 
LDRB R2, [R1],#1 
CMP R2, #0 
SUBEQ RO, R1, RO 
SUBEQ RO, RO, #1 
BNE loc 2C8 
BX LR 


Almost the same as what we saw before, with the exception that the str - eos- 1 
expression can be computed not at the function's end, but right in the body of the 
loop. The -EQ suffix, as we may recall, implies that the instruction executes only if 
the operands in the CMP that has been executed before were equal to each other. 
Thus, if RO contains O, both SUBEQ instructions executes and result is left in the RO 
register. 


ARM64 


Optimizing GCC (Linaro) 4.9 


my strlen: 
mov x1, x0 
; X1 is now temporary pointer (eos), acting like cursor 
.L58: 
; load byte from X1 to W2, increment X1 (post-index) 
ldrb w2, [x1],1 
; Compare and Branch if NonZero: compare W2 with 0, 
; jump to .L58 if it is not 
cbnz w2, .L58 
; calculate difference between initial pointer 
; in X0 and current address in X1 


sub x0, x1, x0 
; decrement Lowest 32-bit of result 
sub w0, w0, #1 


107MoVe Not 
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ret 


The algorithm is the same as in 1.23.1 on page 255: find a zero byte, calculate the 
difference between the pointers and decrement the result by 1. Some comments 
were added by the author of this book. 


The only thing worth noting is that our example is somewhat wrong: 
my strlen() returns 32-bit int, while it has to return size t or another 64-bit type. 


The reason is that, theoretically, strlen() can be called for a huge blocks in memory 
that exceeds 4GB, so it must able to return a 64-bit value on 64-bit platforms. 


Because of my mistake, the last SUB instruction operates on a 32-bit part of register, 
while the penultimate SUB instruction works on full the 64-bit register (it calculates 
the difference between the pointers). 


It’s my mistake, it is better to leave it as is, as an example of how the code could 
look like in such case. 


Non-optimizing GCC (Linaro) 4.9 


my strlen: 
; function prologue 
sub sp, sp, £32 


; first argument (str) will be stored in [sp,8] 
str x0, [sp,8] 
ldr x0, [sp,8] 

; copy "str" to "eos" variable 


str x0, [sp,24] 
nop 
.L62: 
; eostt+ 
ldr x0, [sp,24] ; load "eos" to X0 
add x1, x0, 1 ; increment X0 
str xl, [sp,24] ; save XO to "eos" 


; load byte from memory at address in X0 to WO 
ldrb wO, [x0] 
; is it zero? (WZR is the 32-bit register always contain zero) 


cmp w0, wzr 
; jump if not zero (Branch Not Equal) 
bne .L62 


; zero byte found. now calculate difference. 
; load "eos" to X1 

ldr X1, [sp,24] 
; load "str" to X0 

ldr x0, [sp,8] 
; calculate difference 

sub x0, x1, x0 
; decrement result 

sub w0, w0, #1 
; function epilogue 

add sp, sp, 32 
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ret 


It's more verbose. The variables are often tossed here to and from memory (local 
stack). The same mistake here: the decrement operation happens on a 32-bit regis- 
ter part. 


MIPS 
Listing 1.193: Optimizing GCC 4.4.5 (IDA) 

my strlen: 
; "eos" variable will always reside in $vl: 

move $vl, $a0 
loc 4: 
; load byte at address in "eos" into $al: 

lb $al, 0($v1) 

or gat, $zero ; load delay slot, NOP 


if loaded byte is not zero, jump to loc 4: 

bnez $al, loc 4 

" anyway: 

addiu $v1, 1 ; branch delay slot 
; loop finished. invert "str" variable: 


increment "eos 


nor $v0, $zero, $a0 
; $v0--str-1 
jr $ra 
; return value = $v1 + $v0 = eos + ( -str-1 ) = eos - str - 1 


addu $v0, $v1, $vO ; branch delay slot 


MIPS lacks a NOT instruction, but has NOR which is OR + NOT operation. 


This operation is widely used in digital electronics*%. For example, the Apollo Guid- 
ance Computer used in the Apollo program, was built by only using 5600 NOR gates: 
[Jens Eickhoff, Onboard Computers, Onboard Software and Satellite Operations: An 
Introduction, (2011)]. But NOR element isn't very popular in computer programming. 


So, the NOT operation is implemented here as NOR DST, $ZERO, SRC. 


(Bitwise inverting a signed number is the same as changing its sign and subtracting 
1 from the result.) 


So what NOT does here is to take the value of str and transform it into -str - 1. The 
addition operation that follows prepares result. 


1.23.2 Boundaries of strings 


It’s interesting to note, how parameters are passed into win32 GetOpenFileName() 
function. In order to call it, one must set list of allowed file extensions: 


OPENFILENAME *LPOPENFILENAME; 


108NOR is called "universal gate" 
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char * filter = "Text files (*.txt)X0*.txtNOMS Word files (*.doc) / 
S N0*.docN0NO"; 


LPOPENFILENAME = (OPENFILENAME *)malloc(sizeof(OPENFILENAME)); 


LPOPENFILENAME->1pstrFilter = filter; 


if(GetOpenFileName(LPOPENFILENAME)) 
{ 


What happens here is that list of strings are passed into GetOpenFileName(). It is 
not a problem to parse it: whenever you encounter single zero byte, this is an item. 
Whenever you encounter two zero bytes, this is end of the list. If you will pass this 
string into printf (), it will treat first item as a single string. 


So this is string, or...? It’s better say this is buffer containing several zero-terminated 
C-strings, which can be stored and processed as a whole. 


Another example is strtok() function. It takes a string and write zero bytes in the 
middle of it. It thus transforms input string into some kind of buffer, which has 
several zero-terminated C-strings. 


1.24 Replacing arithmetic instructions to other ones 


In the pursuit of optimization, one instruction may be replaced by another, or even 
with a group of instructions. For example, ADD and SUB can replace each other: line 
18 in listing.3.122. 


For example, the LEA instruction is often used for simple arithmetic calculations: .1.6 
on page 1299. 

1.24.1 Multiplication 

Multiplication using addition 


Here is a simple example: 


unsigned int f(unsigned int a) 


{ 
F 


return a*8; 


Multiplication by 8 is replaced by 3 addition instructions, which do the same. Appar- 
ently, MSVC's optimizer decided that this code can be faster. 


Listing 1.194: Optimizing MSVC 2010 


TEXT | SEGMENT 
_ag = 8 ; size = 4 
_f PROC 
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mov eax, DWORD PTR  a$[esp-4] 
add eax, eax 
add eax, eax 
add eax, eax 
ret 0 
f ENDP 
_ TEXT ENDS 


Multiplication using shifting 


Multiplication and division instructions by a numbers that's a power of 2 are often 
replaced by shift instructions. 


unsigned int f(unsigned int a) 


1 
return a*4; 
$; 
Listing 1.195: Non-optimizing MSVC 2010 
_ag = 8 ; size = 4 
_f PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
shl eax, 2 
pop ebp 
ret 0 
f ENDP 


Multiplication by 4 is just shifting the number to the left by 2 bits and inserting 2 
zero bits at the right (as the last two bits). It is just like multiplying 3 by 100 —we 
just have to add two zeros at the right. 


That's how the shift left instruction works: 


ESTARIA 
Ea EES EES SE 
The added bits at right are always zeros. 


Multiplication by 4 in ARM: 
Listing 1.196: Non-optimizing Keil 6/2013 (ARM mode) 


f PROC 
LSL r0,r0,#2 
BX lr 
ENDP 
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Multiplication by 4 in MIPS: 
Listing 1.197: Optimizing GCC 4.4.5 (IDA) 


jr $ra 
sll $v0, $a0, 2 ; branch delay slot 


SLL is “Shift Left Logical”. 


Multiplication using shifting, subtracting, and adding 


It’s still possible to get rid of the multiplication operation when you multiply by num- 
bers like 7 or 17 again by using shifting. The mathematics used here is relatively 
easy. 


32-bit 


#include <stdint.h> 


int fl(int a) 


1 
return a*7; 
ur 
int f2(int a) 
1 
return a*28; 
ur 
int f3(int a) 
1 
return a*17; 
i 
x86 
Listing 1.198: Optimizing MSVC 2012 
; a*7 
a$ = 8 
fl PROC 
mov ecx, DWORD PTR a$[esp-4] 
; ECX=a 
lea eax, DWORD PTR [ecx*8] 
; EAX=ECX*8 
sub eax, ecx 
; EAX=EAX-ECX=ECX*8 - ECX=ECX* 7=a*7 
ret 0 
fl ENDP 
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; a*28 
_ag = 8 
_f2 PROC 
mov ecx, DWORD PTR _a$[esp-4] 
; ECX=a 
lea eax, DWORD PTR [ecx*8] 
; EAX=ECX*8 
sub eax, ecx 
; EAX=EAX-ECX=ECX*8 - ECX=ECX*7=a*7 
shl eax, 2 
; EAX=EAX<<2=(a*7)*4=a*28 
ret 0 
_f2 ENDP 
; a*17 
_a$ = 8 
_f3 PROC 
mov eax, DWORD PTR a$[esp-4] 
; EAX=a 
shl eax, 4 
; EAX=EAX<<4=EAX*16=a*16 
add eax, DWORD PTR a$[esp-4] 
; EAX=EAX+a=a*16+a=a*17 
ret 0 
_ 3 ENDP 
ARM 


Keil for ARM mode takes advantage of the second operand's shift modifiers: 


Listing 1.199: Optimizing Keil 6/2013 (ARM mode) 


; a*7 
|| 1] | PROC 
RSB r0,r0,r0,LSL #3 
; RO=RO<<3 - RO=R0*8 - RO=a*8 - a=a*7 
BX lr 
ENDP 
; a*28 
|| f2|] PROC 
RSB r0,r0,r0,LSL #3 
; RO=RO<<3 - RO=R0*8 -RO=a*8 - a=a*7 
LSL r0,r0,#2 
; RO=RO<<2=R0*4=a*7*4=a*28 
BX lr 
ENDP 
; a*17 
|| f3|] PROC 
ADD r0,r0,r0,LSL #4 


; RO=RO+RO<<4=RO0+RO*16=RO*17=a*17 
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BX 
ENDP 


lr 


But there are no such modifiers in Thumb mode. It also can't optimize f2(): 


Listing 1.200: Optimizing Keil 6/2013 (Thumb mode) 


; d*7 
|| f1|| PROC 
LSLS r1,r0,#3 
; R1=R0O<<3=a<<3=a*8 
SUBS ro,r1,ro 
; RO=R1-RO=a*8 - a=a*7 
BX lr 
ENDP 
; a*28 
|| f2|] PROC 
MOVS rl,Z0x1lc ; 28 
; R1=28 
MULS r0,r1,r0 
; RO-R1*R0-28*a 
BX lr 
ENDP 
; a*17 
|| #3] | PROC 
LSLS r1,r0,#4 
; R1=R0<<4=R0*16=a* 16 
ADDS ro,ro, rl 
; RO=R0O+R1=a+a*16=a*17 
BX lr 
ENDP 
MIPS 
Listing 1.201: Optimizing GCC 4.4.5 (IDA) 
fl: 
sll $v0, $a0, 3 
; $vO = $a0««3 = $a0*8 
jr $ra 
subu $v0, $a0 ; branch delay slot 
; $vO = $v0-$a0 = $a0*8-$a0 = $a0*7 
_f2: 
sll $v0, $a0, 5 
; $v0 = $a0<<5 = $a0*32 
sll $a0, 2 
; $a0 = $a0<<2 = $a0*4 
jr $ra 
subu $v0, $a0 ; branch delay slot 
If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


272 


; $v0 = $a0*32-$a0*4 = $a0*28 


f3: 

sll $v0, $a0, 4 
; $v0 = $a0<<4 = $a0*16 

jr $ra 


addu $v0, $a0 ; branch delay slot 
; $v0 = $a0*16+$a0 = $a0*17 


64-bit 


#include «stdint.h» 


int64 t fl(int64 t a) 


1 
return a*7; 
yi 
int64 t f2(int64 t a) 
{ 
return a*28; 
ur 
int64 t f3(int64 t a) 
1 
return a*17; 
ur 
x64 
Listing 1.202: Optimizing MSVC 2012 
; a*7 
f1: 
lea rax, [0+rdi*8] 
; RAX=RDI*8=a*8 
sub rax, rdi 
; RAX=RAX-RDI=a*8 -a=a*7 
ret 
; a*28 
f2: 
lea rax, [0+rdi*4] 
; RAX=RDI*4=a*4 
sal rdi, 5 
; RDI=RDI<<5=RDI*32=a*32 
sub rdi, rax 
; RDI=RDI -RAX=a*32-a*4=a*28 
mov rax, rdi 
ret 
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; a*17 
f3: 
mov rax, rdi 
sal rax, 4 
; RAX-RAX««4-a* 16 
add rax, rdi 
; RAX=a*16+a=a*17 
ret 
ARM64 


GCC 4.9 for ARM64 is also terse, thanks to the shift modifiers: 
Listing 1.203: Optimizing GCC (Linaro) 4.9 ARM64 


; a*7 
fl: 
Isl x1, x0, 3 
; X1=X0<<3=X0*8=a*8 
sub x0, x1, x0 
; X0=X1-X0=a*8-a=a*7 
ret 
; a*28 
f2: 
Isl x1, x0, 5 
; X1=X0<<5=a*32 
sub x0, x1, x0, lsl 2 
; X0=X1-X0<<2=a*32 -a<<2=a*32-a*4=a*28 
ret 
; a*17 
f3: 
add x0, x0, x0, lsl 4 
; X0=X0+X0<<4=a+a*16=a*17 
ret 


Booth's multiplication algorithm 


There was a time when computers were big and that expensive, that some of them 
lacked hardware support of multiplication operation in CPU, like Data General Nova. 
And when one need multiplication operation, it can be provided at software level, for 
example, using Booth's multiplication algorithm. This is a multiplication algorithm 
which uses only addition operation and shifts. 


What modern optimizing compilers do, isn't the same, but the goal (multiplication) 
and resources (faster operations) are the same. 
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1.24.2 Division 
Division using shifts 


Example of division by 4: 


unsigned int f(unsigned int a) 


1 
i 


return a/4; 


We get (MSVC 2010): 
Listing 1.204: MSVC 2010 


_a$ = 8 ; size = 4 

_f PROC 
mov eax, DWORD PTR _a$[esp-4] 
shr eax, 2 
ret 0 

f ENDP 


The SHR (SHift Right) instruction in this example is shifting a number by 2 bits to the 
right. The two freed bits at left (e.g., two most significant bits) are set to zero. The 
two least significant bits are dropped. In fact, these two dropped bits are the division 
operation remainder. 


The SHR instruction works just like SHL, but in the other direction. 


Se EA 
a EES 
It is easy to understand if you imagine the number 23 in the decimal numeral system. 


23 can be easily divided by 10 just by dropping last digit (3—division remainder). 2 
is left after the operation as a quotient. 


So the remainder is dropped, but that’s OK, we work on integer values anyway, these 
are not a real numbers! 


Division by 4 in ARM: 
Listing 1.205: Non-optimizing Keil 6/2013 (ARM mode) 


f PROC 
LSR r0,r0,#2 
BX lr 
ENDP 


Division by 4 in MIPS: 
Listing 1.206: Optimizing GCC 4.4.5 (IDA) 


jr $ra 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


275 


srl $v0, $a0, 2 ; branch delay slot 


The SRL instruction is "Shift Right Logical". 


1.24.3 Exercise 
* http://challenges.re/59 


1.25 Floating-point unit 
The FPU is a device within the main CPU, specially designed to deal with floating 
point numbers. 


It was called "coprocessor" in the past and it stays somewhat aside of the main CPU. 


1.25.1 IEEE 754 


A number in the IEEE 754 format consists of a sign, a significand (also called fraction) 
and an exponent. 


1.25.2 x86 


It is worth looking into stack machines or learning the basics of the Forth language, 
before studying the FPU in x86. 


It is interesting to know that in the past (before the 80486 CPU) the coprocessor 
was a separate chip and it was not always pre-installed on the motherboard. It was 
possible to buy it separately and install it 1°9. 


Starting with the 80486 DX CPU, the FPU is integrated in the CPU. 


The FWAIT instruction reminds us of that fact—it switches the CPU to a waiting state, 
So it can wait until the FPU has finished with its work. 


Another rudiment is the fact that the FPU instruction opcodes start with the so called 
"escape"-opcodes (D8. .DF), i.e., opcodes passed to a separate coprocessor. 


The FPU has a stack capable to holding 8 80-bit registers, and each register can hold 
a number in the IEEE 754 format. 


They are ST(0)..ST(7). For brevity, IDA and OllyDbg show ST(0) as ST, which is 
represented in some textbooks and manuals as "Stack Top". 


109For example, John Carmack used fixed-point arithmetic values in his Doom video game, stored in 32- 
bit GPR registers (16 bit for integral part and another 16 bit for fractional part), so Doom could work on 
32-bit computers without FPU, i.e., 80386 and 80486 SX. 
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1.25.3 ARM, MIPS, x86/x64 SIMD 


In ARM and MIPS the FPU is not a stack, but a set of registers, which can be accessed 
randomly, like GPR. 


The same ideology is used in the SIMD extensions of x86/x64 CPUs. 


1.25.4 C/C++ 


The standard C/C++ languages offer at least two floating number types, float (single- 
precision, 32 bits) 11° and double (double-precision, 64 bits). 


In [Donald E. Knuth, The Art of Computer Programming, Volume 2, 3rd ed., (1997)246] 
we can find the single-precision means that the floating point value can be placed 
into a single [32-bit] machine word, double-precision means it can be stored in two 
words (64 bits). 


GCC also supports the long double type (extended precision, 80 bit), which MSVC 
doesn't. 


The float type requires the same number of bits as the int type in 32-bit environ- 
ments, but the number representation is completely different. 


1.25.5 Simple example 


Let's consider this simple example: 


#include <stdio.h> 


double f (double a, double b) 
{ 


Fi 


return a/3.14 + b*4.1; 


int main() 


{ 
ri 


printf ("%f\n", f(1.2, 3.4)); 


x86 
MSVC 


Compile it in MSVC 2010: 
Listing 1.207: MSVC 2010: f() 


CONST SEGMENT 
. reale4010666666666666 DQ 04010666666666666r ; 4.1 
CONST ENDS 


110the single precision floating point number format is also addressed in the Handling float data type as 
a structure (1.30.6 on page 469) section 
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CONST SEGMENT 


. realQ40091eb851eb851f DQ 040091eb851eb851fr ; 3.14 
CONST ENDS 
. TEXT SEGMENT 
.8a$ = 8 ; size = 8 
_b$ = 16 ; size = 8 
f PROC 
push ebp 
mov ebp, esp 


fld QWORD PTR _a$[ebp] 


current stack state: ST(0) = a 


fdiv | QWORD PTR _ real@40091eb851eb851Ff 


current stack state: ST(0) = result of a divided by 3.14 


fld  QWORD PTR b$[ebp] 


current stack state: ST(0) = b; 
; ST(1) = result of a divided by 3.14 


fmul | QWORD PTR  realQ4010666666666666 


current stack state: 
; ST(0) = result of b * 4.1; 
; ST(1) = result of a divided by 3.14 


faddp ST(1), ST(0) 


; current stack state: ST(0) = result of addition 
pop ebp 
ret 0 

_f ENDP 


FLD takes 8 bytes from stack and loads the number into the ST(0) register, automat- 
ically converting it into the internal 80-bit format (extended precision). 


FDIV divides the value in ST(0) by the number stored at address 

. realq40091eb851eb851f —the value 3.14 is encoded there. The assembly syntax 
doesn't support floating point numbers, so what we see here is the hexadecimal 
representation of 3.14 in 64-bit IEEE 754 format. 


After the execution of FDIV ST(0) holds the quotient. 


By the way, there is also the FDIVP instruction, which divides ST(1) by ST(0), pop- 
ping both these values from stack and then pushing the result. If you know the Forth 
language, you can quickly understand that this is a stack machine. 


The subsequent FLD instruction pushes the value of b into the stack. 
After that, the quotient is placed in ST(1), and ST(0) has the value of b. 


The next FMUL instruction does multiplication: b from ST(0) is multiplied by value at 
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. realq4010666666666666 (the number 4.1 is there) and leaves the result in the 
ST(0) register. 
The last FADDP instruction adds the two values at top of stack, storing the result in 
ST(1) and then popping the value of ST(0), thereby leaving the result at the top of 
the stack, in ST(0). 


The function must return its result in the ST(0) register, so there are no any other 
instructions except the function epilogue after FADDP. 
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MSVC + OllyDbg 


2 pairs of 32-bit words are marked by red in the stack. Each pair is a double-number 
in IEEE 754 format and is passed from main(). 


We see how the first FLD loads a value (1.2) from the stack and puts it into ST(0): 


CPU - main thread, module simple  - [Bl xí 
J i ^ 


00202848 
6E494714 ASCII "H(-" 
2 
FLORT @G16F9AC 
OBÍSFIAC 
0009001 
OBFF3388 AFF 


GOFF 1966 


FFFFFFFF) 
@( FFFFFFFF) 
G( FFFFFFFF) 
GUFFFFFFFF) 
7EFODG86( FFF) 

GS 0028 OCFFFFFFFF) 


LastErr 
aaaaa2a6 


LaFF28 FLORT 


FLORT 


2180 
Cond 8 8 O à Err 
Prec NEAR,S3 Mask 
Last omnd 9623: 0GFF1963 simple.8l 


A 

FF FF FF FF|FF FF FF FF 
FE FF FF FF A g z '5e 
H(- hN- 


RETURN from simpl: 


ASCII ”pN-” 


mmmmmmmmmmmmmmmmmm 


Figure 1.62: OllyDbg: the first FLD has been executed 


Because of unavoidable conversion errors from 64-bit IEEE 754 floating point to 80- 
bit (used internally in the FPU), here we see 1.1999..., which is close to 1.2. 


EIP now points to the next instruction (FDIV), which loads a double-number (a con- 
stant) from memory. For convenience, OllyDbg shows its value: 3.14 
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Let's trace further. FDIV has been executed, now ST(0) contains 0.382...(quotient): 


PUSH EBP 
MOU EBP, ESP "m 
FLO WORD PTR SS:LBRG.11 ASCII "H(-" 
FDIU QWORD PTR OS: LGFF20D81 se 

FLD QUORD PTR SS: 


SS: . 
FMUL QWORD PTR DS: [OFF20C8] 
a ge eed 


mp le. BOFF3388 
EIP ØØFF100C mp le. 0OFF100C 


: S BLFFFFFFFF) 
: BLFFFFFFFF) 
BLFFFFFFFF) 
BLFFFFFFFF) 
t TEFDDBBB(FFF) 
BCFFFFFFFF) 
SUB ESP,8 


DDOS Ea2arrFot FLO GWORD PTR DS: COFF20E0] i 20000 ERROR_SUCCESS 
ESIR AKORD PTR $$:[LOCAL.2] B, NE, A, PE, GE, 6) 


; 
FLO GWORD PTR DS:LBFF20D81 
FSTP QUORD PTR SS: LOCAL. 41 
CALL GFF 1008 STS emp 

ADD ESP, 8 e at 
BBFF1043 FSTP QWUDRD PTR SS:ELOCRL.21 m STE empty 
GOFF 1046 PUSH OFFSET BBFF38BB . 5 
Stack LOBIGFSBCI-3 7 empti m 


e 


PUSH EBP 
MOU EBP,ESP 


oOc-o0mno 


BOFF103B 
BOFF1O 


eom m ot om om m on n n n 4 


P 
1 
1 
simple. GGF 


RETURN from simpl 


RETURN from simpl: 
ASCII "ph-'' 


a 
TEFDEGGA 
a a 


Figure 1.63: OllyDbg: FDIV has been executed 
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Third step: the next FLD has been executed, loading 3.4 into ST(0) (here we see the 
approximate value 3.39999...): 


CPU - main thread, module simple 
PUSH EBP 
MOU EBP,ESP 
FLD GWORD PTR SS:LBRRG.11 
FDIU GWORD PTR DS: [OFF20007 
FLO QWORD PTR SS: CARG.3] 
FMUL GWORD PTR DS: (@FF26C81 
AE ET 


ET dd 
El 7TEFDDaaatFFF) 

PUSH EBP G at 

MOU EBP,ESP a atFFFFFFFF) 

DDOS ÉüarFal FLD ESPRE PTR DS: [OFF20E0] 

aa SWORD PTR SS: [LOCAL.21 


FLO GUORD PTR DS: [OFF2008] 
FSTP QWORD PTR SS:CLOCAL.4] 
ES COFFFFFF | CALL aarrFiaaa 


wor m om tm om m n] n de 


83C4 a8 ADD ESP,S 
DD1C24 FSTP QWORD PTR SS: [LOCAL.2] 
68 GOSOFFOG | PUSH OFFSET 09FF3000 


Oorr acs -100000000000000 
ST=3. 3999999999999999110 


RETURN from simpl 


8 Z '5em 


Hi- hN- 


RETURN from simpl 


ASCII ”pN-” 


Figure 1.64: OllyDbg: the second FLD has been executed 


At the same time, quotient is pushed into ST (1). Right now, EIP points to the next 
instruction: FMUL. It loads the constant 4.1 from memory, which OllyDbg shows. 
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Next: FMUL has been executed, so now the product is in ST(0): 


CPU - main thread, module simple 


PUSH EBP 

MOU EBP,ESP 

FLO QWORD PTR SS: [ARG. 1] 
FDIU QWORD PTR DS: [OFF2000] 
FLO QWORD PTR SS: [ARG.3] 
FMUL QWORD PTR DS: [OFF20C8] 


simple. BBFF3388 
sinh le. GOFF 1018 


Gt FFFFFFFF) 
G( FFFFFFFF) 

; B(FFFFFFFF) 

IN ü ü BL EFFFFFFF) 

PUSH EBP ] S t 7EFDDOBB(FFF) 


MOU EBP, ESP a GS : GCFFFFFFFF) 
SUB ESP,S 

FLO QWORD PTR DS: COFF20E0] 
FSTP_QUORD PTR SS:CLOCAL.2] 
SUB ESP, 8 

FLO QWORD PTR DS: [OFF20D8] 
FSTP QWORD PTR SS:CLOCAL.4] 
ES COFFFFFF | CALL aarFFiaaa 


eomm om om m om m n n n 4 


S3C4 a8 ADD ESP, 8 
DD1C24 FSTP QWORD PTR SS:CLOCAL.2] 
68 Ba2arrFoo PUSH OFFSET SOFF 3008 


ST-13. 9299999999999977 30 
8101) 20. 3821656050955413719 


co 
THON 
Koo 


ou 
S 
4 


aa aa an 


RETURN from simpl: 
ASCII "phN-" 


Figure 1.65: OllyDbg: the FMUL has been executed 
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Next: the FADDP has been executed, now the result of the addition is in ST(0), and 
ST(1) is cleared: 


CPU - main thread, module simple  - [Bl xl 


PUSH EBP 

MOU EBP,ESP 

FLD GWORD PTR SS:thRG. 

FDIU QWORD PTR BS: Lor#22003 
FLO QWORD PTR SS: CARG.3 

FMUL QWORD PTR BS: CorF2aC8) 
FADDP ST(1),ST 

POP EBP 


simple. G@F 
d GOFF1817 simple. DOFF1B1 


it BLFFFFFFFF) 
Bt FFFFFFFF) 
B FFFFFFFF) 
BLFFFFFFFF) 


PUSH EBP 7EFODGGG( FFF) 


de Eon | 

FLO QUORD PTR DS: COFF29E9] JEastErr. 29900099 | ERROR SUCCESS 
ESTP _QuORD PTR SS:LLOCRL.21 a NS, FE, GE, 81 
FLD GWORD PTR DS: [OFF20D8] 
FSTP BWORD PTR SS:LLOCRL.41 
ES COFFFFFF |CALL 00FF1999 

3304 08 ADD ESP, 8 

FSTP QUÓRD PTR SS: [LOCAL.2] 
PUSH OFFSET GBFF3008, 


Top of ‘stack TealeFSAC1=0016F9C4 
EBP=0016F9AC 


BO16F9C4 | —* m 
00FF1040|6» [RETURN from simpl 


OOOD 


RETURN from simpl 


ASCII ”pN-” 


Figure 1.66: OllyDbg: FADDP has been executed 


The result is left in ST (0), because the function returns its value in ST (0). 
main () takes this value from the register later. 
We also see something unusual: the 13.93...value is now located in ST(7). Why? 


As we have read some time before in this book, the FPU registers are a stack: 1.25.2 
on page 275. But this is a simplification. 


Imagine if it was implemented in hardware as it's described, then all 7 register's con- 
tents must be moved (or copied) to adjacent registers during pushing and popping, 
and that's a lot of work. 


In reality, the FPU has just 8 registers and a pointer (called TOP) which contains a 
register number, which is the current "top of stack". 


When a value is pushed to the stack, TOP is pointed to the next available register, 
and then a value is written to that register. 


The procedure is reversed if a value is popped, however, the register which has been 
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freed is not cleared (it could possibly be cleared, but this is more work which can 
degrade performance). So that's what we see here. 


It can be said that FADDP saved the sum in the stack, and then popped one element. 
But in fact, this instruction saved the sum and then shifted TOP. 


More precisely, the registers of the FPU are a circular buffer. 
GCC 


GCC 4.4.1 (with -03 option) emits the same code, just slightly different: 
Listing 1.208: Optimizing GCC 4.4.1 


public f 
f proc near 
arg 0 - qword ptr 8 
arg 8 - qword ptr 10h 
push ebp 
fld ds:dbl 8048608 ; 3.14 


; stack state now: ST(0) = 3.14 


mov ebp, esp 
fdivr [ebp+arg_ 0] 


; stack state now: ST(0) = result of division 
fld ds:dbl 8048610 ; 4.1 
; stack state now: ST(0) = 4.1, ST(1) = result of division 


fmul [ebp+arg_ 8] 


; stack state now: ST(0) = result of multiplication, ST(1) = result of 
division 
pop ebp 
faddp  st(1), st 
; stack state now: ST(0) = result of addition 
retn 
f endp 


The difference is that, first of all, 3.14 is pushed to the stack (into ST(0)), and then 
the value in arg 0 is divided by the value in ST(0). 


FDIVR stands for Reverse Divide —to divide with divisor and dividend swapped with 
each other. There is no likewise instruction for multiplication since it is a commuta- 
tive operation, so we just have FMUL without its -R counterpart. 
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FADDP adds the two values but also pops one value from the stack. After that oper- 
ation, ST(0) holds the sum. 


ARM: Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Until ARM got standardized floating point support, several processor manufacturers 
added their own instructions extensions. Then, VFP (Vector Floating Point) was stan- 
dardized. 


One important difference from x86 is that in ARM, there is no stack, you work just 
with registers. 


Listing 1.209: Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


T 
VLDR D16, -3.14 
VMOV D17, RO, R1 ; load "a" 
VMOV D18, R2, R3 ; load "b" 
VDIV.F64 D16, D17, D16 ; a/3.14 
VLDR D17, =4.1 
VMUL. F64 D17, D18, D17 ; b*4.1 
VADD. F64 D16, D17, D16 ; + 
VMOV RO, R1, D16 
BX LR 
dbl 2C98 DCFD 3.14 ; DATA XREF: f 
dbl 2CAO0 DCFD 4.1 ; DATA XREF: f+10 


So, we see here new some registers used, with D prefix. 


These are 64-bit registers, there are 32 of them, and they can be used both for 
floating-point numbers (double) but also for SIMD (it is called NEON here in ARM). 


There are also 32 32-bit S-registers, intended to be used for single precision floating 
pointer numbers (float). 


It is easy to memorize: D-registers are for double precision numbers, while S-registers— 
for single precision numbers. More about it: .2.3 on page 1316. 


Both constants (3.14 and 4.1) are stored in memory in IEEE 754 format. 


VLDR and VMOV, as it can be easily deduced, are analogous to the LDR and MOV in- 
structions, but they work with D-registers. 


It has to be noted that these instructions, just like the D-registers, are intended not 
only for floating point numbers, but can be also used for SIMD (NEON) operations 
and this will also be shown soon. 


The arguments are passed to the function in a common way, via the R-registers, 
however each number that has double precision has a size of 64 bits, so two R- 
registers are needed to pass each one. 


VMOV D17, RO, Rl atthe start, composes two 32-bit values from RO and R1 into one 
64-bit value and saves it to D17. 
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VMOV RO, R1, D16 is the inverse operation: what has been in D16 is split in two reg- 
isters, RO and R1, because a double-precision number that needs 64 bits for storage, 
is returned in RO and R1. 


VDIV, VMUL and VADD, are instruction for processing floating point numbers that com- 
pute quotient, product and sum, respectively. 


The code for Thumb-2 is same. 


ARM: Optimizing Keil 6/2013 (Thumb mode) 


T 
PUSH {R3-R7,LR} 
MOVS R7, R2 
MOVS R4, R3 
MOVS R5, RO 
MOVS R6, R1 
LDR R2, =0x66666666 ; 4.1 
LDR R3, =0x40106666 
MOVS RO, R7 
MOVS R1, R4 
BL . aeabi dmul 
MOVS R7, RO 
MOVS R4, R1 
LDR R2, =0x51EB851F ; 3.14 
LDR R3, =0x40091EB8 
MOVS RO, R5 
MOVS R1, R6 
BL . aeabi ddiv 
MOVS R2, R7 
MOVS R3, R4 


BL . aeabi dadd 

POP {R3-R7,PC} 
; 4.1 in IEEE 754 form: 
dword 364 DCD 0x66666666 ; DATA XREF: f+A 
dword 368 DCD 0x40106666 ; DATA XREF: f+C 
; 3.14 in IEEE 754 form: 
dword 36C DCD 0x51EB851F ; DATA XREF: f+1A 
dword 370 DCD 0x40091EB8 ; DATA XREF: f+1C 


Keil generated code for a processor without FPU or NEON support. 


The double-precision floating-point numbers are passed via generic R-registers, and 
instead of FPU-instructions, service library functions are called 

(like  aeabi dmul, aeabi ddiv,  aeabi dadd) which emulate multiplication, di- 
vision and addition for floating-point numbers. 


Of course, that is slower than FPU-coprocessor, but it's still better than nothing. 


By the way, similar FPU-emulating libraries were very popular in the x86 world when 
coprocessors were rare and expensive, and were installed only on expensive com- 
puters. 
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The FPU-coprocessor emulation is called soft float or armel (emulation) in the ARM 
world, while using the coprocessor's FPU-instructions is called hard float or armhf. 


ARM64: Optimizing GCC (Linaro) 4.9 
Very compact code: 


Listing 1.210: Optimizing GCC (Linaro) 4.9 


f: 
; DO =a, D1 =b 

ldr d2, .LC25 ; 3.14 
; D2 = 3.14 


fdiv do, d0, d2 
; DO = DO/D2 = a/3.14 
ldr d2, .LC26 ; 4.1 
; D2 = 4.1 
fmadd dO, dl, d2, dO 
D1*D2+D0 = b*4.1+a/3.14 
ret 


c 
o 
ll 


; constants in IEEE 754 format: 

.LC25: 
.word 1374389535 ; 3.14 
.word 1074339512 

.LC26: 
.word 1717986918 ; 4.1 
.word 1074816614 


ARM64: Non-optimizing GCC (Linaro) 4.9 


Listing 1.211: Non-optimizing GCC (Linaro) 4.9 


f: 
sub sp, sp, £16 
str dO, [sp,8] ; save "a" in Register Save Area 
str dl, [sp] ; save "b" in Register Save Area 
ldr x1, [sp,8] 

;Xl-a 
ldr x0, .LC25 

; X0 = 3.14 


fmov dO, x1 
fmov dl, x0 

; DO = a, D1 = 3.14 
fdiv dO, dO, dl 


; DO = DO/D1 = a/3.14 
fmov x1, d0 
; XI = a/3.14 
ldr x2, [sp] 
; X2 =b 
ldr x0, .LC26 
; XO = 4,1 
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fmov dO, x2 
fmov dl, x0 


fmul do, dO, dl 
DO*D1 = b*4.1 


fmov x0, dO 
; X0 = DO = b*4.1 
fmov dO, x1 
; DO = a/3.14 
fmov dl, x0 
; D1 = X0 = b*4.1 
fadd dO, dO, dl 


; DO = DO+D1 = a/3.14 + b*4.1 
fmov x0, dO ; Y redundant code 
fmov dQ, x0 ; / 
add sp, sp, 16 
ret 

.LC25: 
.word 1374389535 + 3.414 
.word 1074339512 

.LC26: 


.word 1717986918 ; 4.1 
.word 1074816614 


Non-optimizing GCC is more verbose. 


There is a lot of unnecessary value shuffling, including some clearly redundant code 
(the last two FMOV instructions). Probably, GCC 4.9 is not yet good in generating 
ARM64 code. 


What is worth noting is that ARM64 has 64-bit registers, and the D-registers are 
64-bit ones as well. 


So the compiler is free to save values of type double in GPRs instead of the local 
stack. This isn't possible on 32-bit CPUs. 


And again, as an exercise, you can try to optimize this function manually, without 
introducing new instructions like FMADD. 


1.25.6 Passing floating point numbers via arguments 


#include <math.h> 
#include <stdio.h> 


int main () 
{ 
printf ("32.01 ^ 1.54 = %lf\n", pow (32.01,1.54)); 


return 0; 
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x86 
Let's see what we get in (MSVC 2010): 
Listing 1.212: MSVC 2010 


CONST SEGMENT 

__real@40400147ael47ael DQ 040400147ae147aelr ; 32.01 
. realQ3ff8a3d70a3d70a4 DQ 03ff8a3d70a3d70a4r ; 1.54 
CONST ENDS 


main PROC 
push ebp 
mov ebp, esp 
sub esp, 8 ; allocate space for the first variable 
fld QWORD PTR _ real@3ff8a3d70a3d70a4 
fstp QWORD PTR [esp] 
sub esp, 8 ; allocate space for the second variable 
fld QWORD PTR _ real@40400147ae147ael 
fstp | QWORD PTR [esp] 
call | pow 
add esp, 8 ; return back place of one variable. 


; in local stack here 8 bytes still reserved for us. 
; result now in ST(0) 


; move result from ST(0) to local stack for printf(): 
fstp QWORD PTR [esp] 
push OFFSET $SG2651 
call printf 
add esp, 12 


xor eax, eax 
pop ebp 
ret 0 

main ENDP 


FLD and FSTP move variables between the data segment and the FPU stack. pow()**! 
takes both values from the stack and returns its result in the ST(0) register. printf() 
takes 8 bytes from the local stack and interprets them as double type variable. 


By the way, a pair of MOV instructions could be used here for moving values from the 
memory into the stack, because the values in memory are stored in IEEE 754 format, 
and pow() also takes them in this format, so no conversion is necessary. That's how 
it's done in the next example, for ARM: 1.25.6. 


ARM 4 Non-optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


main 
var C = -0xC 


PUSH {R7,LR} 


111a standard C function, raises a number to the given power (exponentiation) 
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MOV R7, SP 

SUB SP, SP, #4 

VLDR D16, -32.01 

VMOV RO, R1, D16 

VLDR D16, -1.54 

VMOV R2, R3, D16 

BLX _ pow 

VMOV D16, RO, R1 

MOV RO, OxFC1 ; "32.01 ^ 1.54 = %lf\n" 

ADD RO, PC 

VMOV R1, R2, D16 

BLX | printf 

MOVS R1, 0 

STR RO, [SP,ZO0xC-var C] 

MOV RO, R1 

ADD SP, SP, #4 

POP {R7, PC} 
dbl_2F90 DCFD 32.01 ; DATA XREF: _main+6 
dbl 2F98 DCFD 1.54 ; DATA XREF: _main+E 


As it was mentioned before, 64-bit floating pointer numbers are passed in R-registers 
pairs. 


This code is a bit redundant (certainly because optimization is turned off), since it is 
possible to load values into the R-registers directly without touching the D-registers. 


So, as we see, the pow function receives its first argument in RO and R1, and its 
second one in R2 and R3. The function leaves its result in RO and R1. The result of 
_ pow is moved into D16, then in the R1 and R2 pair, from where printf() takes the 
resulting number. 


ARM 4 Non-optimizing Keil 6/2013 (ARM mode) 


main 

STMFD SP!, {R4-R6,LR} 

LDR R2, =0xA3D70A4 ; y 

LDR R3, =0x3FF8A3D7 

LDR RO, =0xAE147AE1 ; x 

LDR R1, =0x40400147 

BL pow 

MOV R4, RO 

MOV R2, R4 

MOV R3, R1 

ADR RO, a32 011 54Lf ; "32.01 ^ 1.54 = %lf\n" 

BL . 2printf 

MOV RO, #0 

LDMFD SP!, {R4-R6,PC} 
y DCD 0xA3D70A4 ; DATA XREF: _main+4 
dword 520 DCD Ox3FF8A3D7 ; DATA XREF: _main+8 
x DCD OxAE147AE1 ; DATA XREF: _main+C 
dword 528 DCD 0x40400147 ; DATA XREF: _main+10 
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a32 011 54Lf DCB "32.01 ^ 1.54 = %lf",0xA,0 
; DATA XREF: _main+24 


D-registers are not used here, just R-register pairs. 


ARM64 + Optimizing GCC (Linaro) 4.9 


Listing 1.213: Optimizing GCC (Linaro) 4.9 


f: 
stp x29, x30, [sp, -16]! 
add x29, sp, 0 
ldr dl, .LC1 ; load 1.54 into D1 
ldr dO, .LCO ; load 32.01 into DO 
bl pow 
; result of pow() in DO 
adrp x0, .LC2 
add x0, x0, :lo12:.LC2 
bl printf 
mov w0, 0 
ldp x29, x30, [sp], 16 
ret 
.LC0: 


; 32.01 in IEEE 754 format 
.word -1374389535 
.word 1077936455 
LCL: 
; 1.54 in IEEE 754 format 
. word 171798692 
. word 1073259479 
.LC2: 
.string "32.01 ^ 1.54 = %lf\n" 


The constants are loaded into DO and D1: pow() takes them from there. The result 
will be in DO after the execution of pow(). It is to be passed to printf() without any 
modification and moving, because printf() takes arguments of integral types and 
pointers from X-registers, and floating point arguments from D-registers. 


1.25.7 Comparison example 
Let's try this: 


#include <stdio.h> 


double d max (double a, double b) 


{ 
if (a>b) 
return a; 


return b; 


ur 
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int main() 
1 
printf ("%f\n", d max (1.2, 3.4)); 
printf ("%f\n", d max (5.6, -4)); 
$; 


Despite the simplicity of the function, it will be harder to understand how it works. 


x86 
Non-optimizing MSVC 


MSVC 2010 generates the following: 
Listing 1.214: Non-optimizing MSVC 2010 


PUBLIC .d max 
_ TEXT SEGMENT 
_a$ = 8 ; size = 8 
_b$ = 16 ; size = 8 
_d_max PROC 

push ebp 

mov ebp, esp 

fld QWORD PTR _b$[ebp] 
; current stack state: ST(0) = b 


compare b (ST(0)) and a, and pop register 


fcomp QWORD PTR _a$[ebp] 


; stack is empty here 


fnstsw ax 
test ah, 5 
jp SHORT $LN1@d_max 


; we are here only if a>b 


fld QWORD PTR _a$[ebp] 
jmp SHORT $LN2@d_max 


$LN1@d_max: 

fld QWORD PTR _b$[ebp] 
$LN2@d_max: 

pop ebp 

ret 0 
_d_ max ENDP 


So, FLD loads b into ST(0). 


FCOMP compares the value in ST(0) with what is in a and sets C3/C2/C0 bits in FPU 
status word register, accordingly. This is a 16-bit register that reflects the current 
state of the FPU. 
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After the bits are set, the FCOMP instruction also pops one variable from the stack. 
This is what distinguishes it from FCOM, which is just compares values, leaving the 
stack in the same state. 


Unfortunately, CPUs before Intel P6 !!? don't have any conditional jumps instructions 
which check the C3/C2/C0 bits. Perhaps, it is a matter of history (recall: FPU was a 
separate chip in past). 

Modern CPU starting at Intel P6 have FCOMI/FCOMIP/FUCOMI/FUCOMIP instructions — 
which do the same, but modify the ZF/PF/CF CPU flags. 


The FNSTSW instruction copies FPU the status word register to AX. C3/C2/C0 bits are 
placed at positions 14/10/8, they are at the same positions in the AX register and all 
they are placed in the high part of AX —AH. 


* If b» ain our example, then C3/C2/C0 bits are to be set as following: O, O, 0. 

e If a» b, then the bits are: 0, O, 1. 

e If a=b, then the bits are: 1, O, O. 

e |f the result is unordered (in case of error), then the set bits are: 1, 1, 1. 
This is how C3/C2/C0 bits are located in the AX register: 


14 10 9 8 


c3 C2C1CQ 


This is how C3/C2/C0 bits are located in the AH register: 


6 2 1 0 


[F === 


After the execution of test ah, 5113, only CO and C2 bits (on O and 2 position) are 
considered, all other bits are just ignored. 


Now let's talk about the parity flag, another notable historical rudiment. 


This flag is set to 1 if the number of ones in the result of the last calculation is even, 
and to O if it is odd. 


Let's look into Wikipedia?!^: 


One common reason to test the parity flag actually has nothing 
to do with parity. The FPU has four condition flags (CO to C3), but 
they cannot be tested directly, and must instead be first copied to the 
flags register. When this happens, CO is placed in the carry flag, C2 
in the parity flag and C3 in the zero flag. The C2 flag is set when e.g. 
incomparable floating point values (NaN or unsupported format) are 
compared with the FUCOM instructions. 


As noted in Wikipedia, the parity flag used sometimes in FPU code, let's see how. 


112Intel P6 is Pentium Pro, Pentium ll, etc. 
1135=101b 
ll4https://en.wikipedia.org/wiki/Parity flag 
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The PF flag is to be set to 1 if both CO and C2 are set to 0 or both are 1, in which case 
the subsequent JP (jump if PF==1) is triggering. If we recall the values of C3/C2/CO 
for various cases, we can see that the conditional jump JP is triggering in two cases: 
if b» a or a — b (C3 bit is not considered here, since it has been cleared by the test 
ah, 5 instruction). 


It is all simple after that. If the conditional jump has been triggered, FLD loads the 
value of bin ST(0), and if it hasn't been triggered, the value of ais loaded there. 


And what about checking C2? 


The C2 flag is set in case of error (NaN, etc.), but our code doesn't check it. 


If the programmer cares about FPU errors, he/she must add additional checks. 
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First OllyDbg example: a=1.2 and b=3.4 


Let's load the example into OllyDbg: 


CPU - main ead, module d 


PUSH EBP 

MOU EBP,ESP 

FLD QWUORD PTR SS:CARG.31 SUCR100.  initenv 
FCOMP QUORD PTR SS: CARG. 11 A EAS 
FSTSW AX 

TEST AH, 05 

JPE SHORT BOFC1015 

FLO QUORD PTR SS:LRRG.11 
JMP SHORT BOFC1018 dhai 
FLD QUORD PTR SS:CARG.31 - 

> BOFC1G86 d n 


FFFFFFFF) 
at FFFFFFFF) 
B FFFFFFFF) 
B(FFFFFFFF) 
7EFODGG6( FFF) 
G(FFFFFFFF) 


DANDO 


30000 ERROR 


B 
FLD QWORD PTR DS: [OFC20E6] 
FSTP_QUORD PTR SS:CLOCAL.2] 
SUB ESP, 8 
FLO QWORD PTR DS:[ØFC2008] 
FSTP QWORD PTR SS:CLOCAL.4] 
CALL eer eee 


........ . 4 


41FEDC IET A 
ANA RETURN from d_max 


25 A A 
FF FF FF FF FF FF FF FF 
FE FF FF FF øi et iex 


8 
HE4 hh 


RETURN from d mas 


Figure 1.67: OllyDbg: first FLD has been executed 


Current arguments of the function: a = 1.2 and b = 3.4 (We can see them in the stack: 
two pairs of 32-bit values). b (3.4) is already loaded in ST(0). Now FCOMP is being 
executed. OllyDbg shows the second FCOMP argument, which is in stack right now. 
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FCOMP has been executed: 


CPU - main thread, module d m I rn ES 
5 P ^ 


FST=0006 (CS-8 


AX=2848 


PUSH EBP 

MOU EBP, ESP. 

FLD QWORD PTR SS: CARG.31 
FCOMP QWORD PTR SS: CARG. 1] 
FSTSW AX 


TEST AH, 05 

JPE SHORT @GFC1615 

FLD QUORD PTR SS:LRRG.11 
JMP SHORT &arciais 

FLD QWORD PTR SS:LRRG.31 


RETN 


INTS 

PUSH EBP 

MOU EBP,ESP 

SUB ESP,3 

FLD QWORD PTR DS: [OFC20E0] 
FSTP QWORD PTR SS:CLOCAL.2] 
SUB ESP,8 


FLD QWORD PTR DS: [OFC2008] 
FSTP QWORD PTR SS:CLOCAL.4] 


CALL aarciaaa 
ADD ESP 


Figure 1.68: OllyDbg 


8 


ei- 


Hi4 hN+ 


: B(FFFFFFFF) 
BLFFFFFFFF) 

t B(FFFFFFFF) 
7EFDDGGG( FFF) 

t G(FFFFFFFF) 


NO, NB, NE, A, NS 


Ø empty Ø 
1 empty 


empty 
(alaa) 


aaFCc11F 
aaaaaoot 
ĝ 


FCOMP has been executed 


We see the state of the FPU’s condition flags: all zeros. The popped value is reflected 
as ST (7), it was written earlier about reason for this: 1.25.5 on page 283. 
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FNSTSW has been executed: 


main thread, module d n 


PUSH EBP 

MOU EBP,ESP 

FLO QWORD PTR SS:LRRG.31 
FCOMP QWORD PTR SS:CARG.1] 
FSTSwW AX 

TEST 


AH, OS 
JPE SHORT BOFC1B15 
FLO QWORD PTR SS:LRRG.11 
JMP SHORT earciais 
FLO QWORD PTR SS:LRRG.31 
FFFFFFFF) 
OLFFFFFFFF) 
OCFFFFFFFF) 
FFFFFFFF) 
t FDDaaatFFF) 
INTS t B(FFFFFFFF) 
PUSH EBP APAPAP ERROR SUCCESS 
MOU EBP,ESP L f aaaaaoaana ERROR. SUCCESS 
SUB ESP,8 a 5 (NO, NB, NE, A, NS, PE, GE, G) 
FLD QWORD PTR DS: [OFC20E0] S 
FSTP_QUORD PTR SS:CLOCAL.2] 
SUB ESP, 8 
FLO QWORD PTR DS: [OFC20D8] 
FSTP QWORD PTR SS:CLOCAL.4] 
CALL aarciaaa 
ADD ESP 


e 


coge 


Gor 


o zo 


8 LIGERA 
Hi4 hh 


Figure 1.69: OllyDbg: FNSTSW has been executed 


We see that the AX register contain zeros: indeed, all condition flags are zero. (Olly- 
Dbg disassembles the FNSTSW instruction as FSTSW—they are synonyms). 
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TEST has been executed: 


CPU - main thread, module d max 


PUSH EBP 
MOU EBP, ESP 

FLO QUORD PTR SS:CARG. 31 " rien 
FCOMP QUORD PTR SS: CARG. 1] : i 
FSTSW AX 


TEST AH, 05 

JPE SHORT BBFC1815 

FLD QUORD PTR SS:LRRG.11 

JMP SHORT GBOFCIO1S Es 

FLD QUORD PTR SS:LhRG.31 - 
FC100E d 


ever ERRET 


(FFFFFFFF) 

Bt FFFFFFFF) 

> B(FFFFFFFF) 

t B(FFFFFFFF) 
: TEFDDOBBLFFF) 

@(FFFFFFFF) 


PUSH EBP 

MOU EBP,ESP 

SUB ESP, 8 

FLO QWORD PTR DS:[ØFC20E0] 

FSTP_QUORD PTR SS:CLOCAL.2] 
SUB ESP, 8 

DDOS D2ZAFCAÍ FLO QWORD PTR DS:[ØFC2008] 

FSTP QWORD PTR SS:CLOCAL.4] 


DD1C24 
ES COFFFFFF | CALL B6FC1000 
8304 a8 ADD ESP 


Jump is taken 
Dest=d_max.@GFC1615 


A a2 
FF FF FF FF F z 
FE FF FF FF a 1 8 stig- 
01 00 00 0 4 8 Hi4 hn 


Figure 1.70: OllyDbg: TEST has been executed 


The PF flag is set to 1. 


Indeed: the number of bits set in 0 is O and 0 is an even number. OllyDbg disassem- 
bles JP as JPE-?—they are synonyms. And it is about to trigger now. 


115]ump Parity Even (x86 instruction) 
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JPE triggered, FLD loads the value of b (3.4) in ST(0): 


CPU - main thread, module d max 


PUSH EBP 

FLO GORD PTR SS: CARG. 31 : 

FCOMP QUORD PTR $S:CARG.1] 6 SUCR100, — in itenv 
FSTSU AX 


TEST AH, 05 depu 
JPE SHORT BOFCIO15 zd 

GE PX T5 
FLD QUORD PTR SS:LRRG.31 dman . @OF CSS 
POP EBP BBFC1019 


t B(FFFFFFFF) 
C BLFFFFFFFF) 
E @( FFFFFFFF) 
D : BLFFFFFFFF) 
FS à it "EFDDBBBLFFF) 
G 3 32 @(FFFFFFFF) 


EDU ESE: ESP: 00099000 ERROR SUCCESS 
SUB ESP.8 ; (NO, NB, E, BE, NS, PE, GE, LE) 
FLO QUORD PTR DS: COFC29E0] 
FSTP QWORD PTR $S:CLOCAL. 2] 
SUB ESP, 

FLD GWORD PTR DS: [OFC29D8] 
FSTP QWORD PTR SS: CLOCAL. 4] 


CALL aarciaeaa 
ADD ESP, 


IDO AONDVO 


......... . de 


empty 

32146 
3800 C a augu E 
FCW 027 NEAR,53_ M: 
Last cmnd BOFCiB15 d 


(+ hh 


4 ee 
DO41FF74 nter to next S 
a 2 p 


Figure 1.71: OllyDbg: the second FLD has been executed 


The function finishes its work. 
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Second OllyDbg example: a=5.6 and b=-4 


Let's load example into OllyDbg: 


CPU - main thread, module d max 


HOU EBP ESP z 
n AX BOBBBBOS 
FLO QWORD PTR SS: CARG.3] 6445617 MSUCR100. 66445617 
FCOMP QWORD PTR SS:CARG.1] gez2DC58 
FSTSU AX 10 


TEST AH, 8S C 
n B041FEDC 
JPE SHORT S@FC1615 B041FEDC 


FLD QWORD PTR SS:CARG.1] 
JMP SHORT @GFC1618 

FLD QWORD PTR SS: CARG.3] = eee 
POP EBP ' BGFC18G6 d. FC1006 
ETN ‘ 


FFFFFFFF) 
FFFFFFFF) 
FFFFFFFF) 
at FFFFFFFF) 
vEFDDaBat FFF) 
G(FFFFFFFF) 


SVeeeore 


PUSH EBP Err 
MOU EBP,ESP E 

SUB ESP, 8 10000206 
FLD QWORD PTR DS: [OFC20E6] : 

FSTP_QUORD PTR SS: LOCAL. 2] 
SUB ESP,8 


FLD GWORD PTR DS: [OFC20D8] 
FSTP QWORD PTR SS:CLOCAL.4] 


CALL aarciaon 


FST 
FCW 627 
Last cp 


25 A Be 
FF FF FF FF FF FF 
FE FF FF FF 81 


PRORA RRRARA 
mmmmmmmmmm 


Figure 1.72: OllyDbg: first FLD executed 


Current function arguments: a = 5.6 and b = -4. b (-4) is already loaded in ST(0). 
FCOMP about to execute now. OllyDbg shows the second FCOMP argument, which is 
in stack right now. 
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FCOMP executed: 


CPU - main thread, module d max 


PUSH EBP 

MOU EBP,ESP 

FLD QWORD PTR SS:LRRG.31 
FCOMP GWORD PTR SS: [ARG.11 
FSTSW AX 


TEST AH, 05 

¿PE SHORT gorciais 

E ee f: 

ELO GUORD PTR $9: CARG. 31 : d max. BBFC3388 
@GFC1609 d_max.GGFC19a9 


t B(FFFFFFFF) 
BLFFFFFFFF) 

> B(FFFFFFFF) 
BLFFFFFFFF) 

> TEFDDBBB(FFF) 
BLFFFFFFFF) 


96696008 ERRO! 
6 (NO,NB,NE,A,NS, 


wo m . n on arr 
< 


< 


yv. 


MOU EBP,ESP 


SUB ESP, 8 
FLD QUORD PTR DS: COFC20E8] 

FSTP_QUORD PTR SS:CLOCAL. 21 

SUB ESP, 8 

FLO GWORD PTR DS: COFC2008] ent 
FSTP QUORD PTR $S:CLOCAL. 41 MEAE 
CALL GGFC100A = 
ADO ESP : 


5 


FST=0100 (C 
R-0009 


Bua FEOS [aeatreEc 


BO41FEFO 
aa41FEF4 


0041FFOS 
aa41FFaC 
aa4iFFia 
GO41FF14 
aa41FFi18 
GO41FF1iC 
GG41FF26 


Figure 1.73: OllyDbg: FCOMP executed 


We see the state of the FPU’s condition flags: all zeros except CO. 
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FNSTSW executed: 


CPU - main thread, module d max 


GOFCIOOO|PS PUSH EBP 
BOF EL Bae FLD BWORD PTR SS: CARG. 21 

6 FCOMP QUORD PTR SS:LRRG.11 T HSUCR100. 6E445617 
FSTSW_AX 


< 


TEST AH, 05 

JPE SHORT @GFC1615 

UP SHORT BoFCIBIs oo 02 

FLD QUORD PTR SS: [ARG. 3] o SS $ nn cri 


t B(FFFFFFFF) 
BLFFFFFFFF) 

> B(FFFFFFFF) 
BLFFFFFFFF) 

> TEFDDBBB(FFF) 
BLFFFFFFFF) 


LastErr 00000000 ERROI 
6 (NO,NB,NE, A, NS, 


< 


eyy.» 


MOU EBP, ESP 


SUB ESP,8 
FLO QUORD PTR DS: [ØFC20E0] 

FSTP_QUORD PTR SS: LOCAL. 21 

SUB ESP,8 

FLO QUORD PTR DS: COFC2008] pica 
FSTP QUORD PTR SS:LLOCRL.41 et 
CALL GGFC100A 
ADO ESP,8 : 


5 


FST @ Cond à 661 
FCW Prec NEAR, 53 
Last cmnd Ø ð 


Bua PRIT [0041FEEC 


GO41FEFG 
GG41FEF4 
RETURN from d_max 


DAE 20/00 oo E EE É : : 0041FFOS 
a0 B OG G04 1FFOC 

: : 0 004 1FF16 

004 1FF14 

004 1FF1S 

004 1FFIC 

9041FF20 


Figure 1.74: OllyDbg: FNSTSW executed 


We see that the AX register contains 0x100: the CO flag is at the 8th bit. 
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TEST executed: 


CPU - main thread, module d max 


ABFCIOBA PUSH EBP 
BAFE 100S FLD GUDRD PTR SS: CARG. 31 ; 
ABS 1 . CR - 617 
F FCOMP QUORD PTR SS:CARG. 11 6E4466 17 aena PERS 
FSTSU AX E 
TEST AH, aS 0041FEDC 
JPE SHORT OBFCiO15 jP Ga41FEDC 
p per ge T. 
FLO QUORO PTR SS: CARG.3] SOLITO dnan. 
BOFCIBBE d max. 


S 882B 32bit 

8823 3; 

Ba2B 

9028 3 O 
S 8853 t 7EFDDGGBLFFF) 
3 BB2B it B(FFFFFFFF) 


IN 
PUSH EBP : s 
MOU EBP,ESP LastErr 60000006 ERROR SUCCI 


SUB ESP,3 66060262 (NO, NB, NE, A,NS,PO, Gl 
FLD QWORD PTR DS: [OFC20E0] 


FSTP_QUORD PTR $S:CLOCAL. 2] 2 empty B. 

SUB ESP,8 empty 

FLD GWORD PTR DS: [9FC20D8] empty 

FSTP QWORD PTR $S:CLOCAL.4] pee a O. 

CALL G@FCiaea empty @. 

z a e ADD ESP, 8 €: empty 6. 

Jump fs not empty -4, cx p 
best=d nas. o0F C1015 0100 Cond aaa 


827 | Prec 


ES: 
GE, 


E 
G) 


5 


aa41FEEC B0B0000 


Hi4 hN+ Bo41FEFO!| CO100098 


Se occ 


96060001) E 
00194E68 
00192848 
BS288FSE 
aaaaaaoaa 
96080688 
7EFDEGSS 
aaaaaaoaa 
C|] aaaaaaaa 
0041FF20|| 0041FFOS 
D041FF24 308 


Figure 1.75: OllyDbg: TEST executed 


The PF flag is cleared. Indeed: 


the count of bits set in 0x100 is 1 and 1 is an odd number. JPE is being skipped now. 
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JPE hasn't been triggered, so FLD loads the value of a (5.6) in ST(0): 


CPU - main thread, module d max 


PUSH EBP 
FLD BWORD PTR SS: CARG. 31 

: A ISUCR188. 65445617 
FCOMP QUORD PTR SS:LRRG.11 FISUCRI 0G; SEq4561. 
FSTSU AX 
TEST AH, 05 
JPE SHORT BOFCIO1S 
FLD QUORD PTR SS:CARG. 1] T 
JMP SHORT OGFC1018 : an 
FLD QUORD PTR SS:LRRG.31 € L 

BØFC1013 d. FC1813 


ES B(FFFFFFFF) 
acFFFFFFFF) 
at FFFFFFFF) 
atFFFFFFFF) 
£ 7EFODGGG( FFF) 
IN 7 G(FFFFFFFF) 


PUSH EBP rr 6 20 ERROR SUCCESS 
MOU EBP,ESP BB ERROR UCCESS 
SUB ESP,8 ` PO, GE, G) 
FLD QWORD PTR DS: [OFC20E6] r 

FSTP_QWORD PTR SS:LLOCRL.21 
SUB ESP, 8 

FLD QWORD PTR DS:[ØFC2008] 
FSTP QWORD PTR SS:[LOCAL.4] 
CALL aarciaeaa 

ADD ESP, 8 


nn 


FF FF FF 
FE FF FF FF| 81 
(+ hNS 


Figure 1.76: OllyDbg: second FLD executed 


The function finishes its work. 


Optimizing MSVC 2010 


Listing 1.215: Optimizing MSVC 2010 


_a$ = 8 ; size = 8 
_b$ = 16 ; size 8 
_d_ max PROC 
fld QWORD PTR b$[esp-4] 
fld QWORD PTR _a$[esp-4] 


; current stack state: ST(0) = a, ST(1) 


ll 
o 


fcom ST(1) ; compare a and ST(1) 
fnstsw ax 

test ah, 65 ; 00000041H 

jne SHORT $LN5Gd max 


ll 
~ 
o 
— 
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; copy ST(0) to ST(1) and pop register, 
; leave ( a) on top 
fstp ST(1) 


; current stack state: ST(0) = a 
ret 0 
$LN5Gd max: 


; copy ST(0) to ST(0) and pop register, 
; leave ( b) on top 


fstp ST(0) 
; current stack state: ST(0) = b 
ret 0 


d max ENDP 


FCOM differs from FCOMP in the sense that it just compares the values and doesn't 
change the FPU stack. Unlike the previous example, here the operands are in reverse 
order, which is why the result of the comparison in C3/C2/C0 is different: 


* If a» bin our example, then C3/C2/C0 bits are to be set as: 0, O, O. 
* If b» a, then the bits are: O, O, 1. 
* Ifa =b, then the bits are: 1, O, O. 


The test ah, 65 instruction leaves just two bits —C3 and CO. Both will be zero if 
a >b: in that case the JNE jump will not be triggered. Then FSTP ST(1) follows —this 
instruction copies the value from ST(0) to the operand and pops one value from the 
FPU stack. In other words, the instruction copies ST(0) (where the value of a is 
now) into ST(1). After that, two copies of a are at the top of the stack. Then, one 
value is popped. After that, ST(0) contains a and the function is finishes. 


The conditional jump JNE is triggering in two cases: if 6» a ora — b. ST(0) is copied 
into ST(0), it is just like an idle (NOP) operation, then one value is popped from the 
stack and the top of the stack (ST(0)) is contain what has been in ST(1) before (that 
is b). Then the function finishes. The reason this instruction is used here probably is 
because the FPU has no other instruction to pop a value from the stack and discard 
it. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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First OllyDbg example: a=1.2 and b=3.4 


Both FLD are executed: 


CPU - main thread, module d max Mie xl 
P 


DD4424 GC FLD QWORD PTR SS: CARG.3] 
DD4424 84 FLD QWORD PTR SS: [ARG.1] 
D801 FCOM ST(1) 


H, 4 


AH, 41 
JNZ SHORT 00A91014 
FSTP ST(1) 

RETN à 
FSTP ST 3 
RETN j 
IN 80091008 


IN o t B(FFFFFFFF) 
n Gt FFFFFFFF) 
IN FFFFFFFF) 
IN k BLFFFFFFFF) 
IN t vEFDDBOBLFFF) 
IN B @(FFFFFFFF) 
INTS 

FLO QWORD PTR DS: [OA920E0] 

PUSH ESI 

83EC 18 SUB ESP, 10 

DDSC24 B8 | FSTP GWORD PTR SS:LLOCRL.21 

DDS FLD QWORD PTR DS: [6A92008] 

DD1C24 FSTP QWORD PTR SS:LLOCRL.41 

ES C4FFFFFF [CALL _60A91000 

8B25 MOU ESI, DWORD PTR DS: C<&MSUCR1O0. printf 
DD5C24 B8 — |FSTP BWDRD PTR SS:LLOCRL.21 


$T(1)=3.39999999999999991 16) 
ST=1. 1999999999999999568 


25 n S 
FF FF FF FF|FF 
FE FF FF FFIO 


RETURN from d mas 
II ”pNx” 


to next Sly 


Figure 1.77: OllyDbg: both FLD are executed 


FCOM being executed: OllyDbg shows the contents of ST(0) and ST(1) for conve- 
nience. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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FCOM has been executed: 


C main thread, module d max (Oj x! 
y P ^ 
rs : 


DD4424 ØC FLO QWORD PTR SS:LRRG.31 
DD4424 84 FLO QWORD PTR SS:LRRG.11 
DSD1 FCOM ST(1) 

DFEG FSTSU AX 


TEST RH,41 
JNZ SHORT 88891814 
STP ST(1) 

ST 


BLFFFFFFFF) 
it B(FFFFFFFF) 

FS it "EFDDBBBLFFF) 
GS ; it B(FFFFFFFF) 


bes gozonal ELO OWORD PTR DS:rOnS20EO1 LastErr 90000000 ERROR SUCCESS 
56 PUSH ESI y 66806262 (NO0, NB, NE, A, NS, PO, GE, G) 
83EC 10 SUB ESP, 10 zi h " 
DOSC24 øe — |FSTP GWORD PTR SS: [LOCAL.21 ere vadis 5116 
DDAS DE20A9al FLO GuORD PTR DS: LOAS2aD81 Ai 
DD1C24 FSTP QWORD PTR SS:LLOCRL.41 iiid 
ES C4FFFFFF | CALL geAsioga genet 
MOU ESI, DWORD PTR DS: [<EMSUCR1B0. printf + 


.... +... n dr 


8835 Ba2onon! 
DDSC24 68 FSTP QWORD PTR SS:LLOCRL.21 


HIX hNX > 
21FC78 E RETURN from d_max 
BO21FC7 3 
2 ASCII "pNX" 


Point 


r to next Sly 
ab E 


Figure 1.78: OllyDbg: FCOM has been executed 


CO is set, all other condition flags are cleared. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


FNSTSW has been executed, AX=0x3100: 


CPU - main thread, module d max 


DD4424 04 | FLO GORD PTR 8S: LARG: 1] gisters LER = 
D8D1 FCOM STC1) eds c "üdninistrator" 


"snm 


EDX Gaaaaana 
EBX aaaacaoa 

SP @621FC6a 
EBP 0021FCB8 
ESI 000090081 
H C3 EDI 900493388 4. 10A93338 
aanoiai? E EIP ØØA9100C 4. BA91GBC 


9991018 i ) 
AGERE it B(FFFFFFFF) 
t B(FFFFFFFF) 
OBAS101A 
BA‘ t B(FFFFFFFF) 
00091016 OLFFFFFFFF) 
8GA91G1C ; ?EFODOBBLFFF) 
99991610 G(FFFFFFFF) 


20A9101E 

oBAS1B1F| CC INTS Sp re 
DDes EO20890l FLD QUORD PTR DS:L8R928EO1 LasvErr 09600800 ERROR SUCCESS 
56 PUSH ESI 68666262 (NO,NB,NE,A,NS,PO,GE,G) 


aan91828 

Godolge.||: B3Ec 10 SUB ESP, 10 
DOSC24 øg  |FSTP DWÜRD PTR SS:[LOCAL.21 eTo Malld l.l SOS DOO TIE 
DDoS FLD QUDRD PTR DS: COA920D8] valli gra AS 
DD1C24 FSTP QUORD PTR SS:LLOCRL.41 : 

EB C4FFFFFF | CALL 0A91000 

8835 MOU ESI, DWORD PTR DS: L«SMSUCRI8B. printf 


DOAHNNDDO 
20000000 


wor om om +... . 4 


DDSC24 68 FSTP_QUORD PTR SS:LLOCRL.21 


3210 S 
ond 8 O à 1 Erro 
rec NEAR,S3 Mask 
023: 00491008 d_max. Bl 

RET - 
Exi] 
Di : - : :Q74— 33333333 
End 6 Hex AN 40083233 
anoanaan ; a = > 96000061) 6 

eens ag s|Lagnsi1E0 RETURN from d max 
gara 2 a : : 00000001|6 
BO21FCS0| MMS84E68|hNX | ASCII "pNX" 

GG21FC84) 88582848) Hí? 
@621FC88) BS16C583 
GG21FC8C| aaaaanaa 
8621FC96| aeaaaaan 
E 7EFDEGSS 
aagaaaaca 
00009000 
@621FC83 
6F0794F3 
eeciFCRA Ift [Pointer to next Sly 


Figure 1.79: OllyDbg: FNSTSW is executed 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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TEST is executed: 


CPU - main thread, module d max 


Sf pine. gees qo Een iste (E 
A910 H . A E L7 
ETTE FCOM ST(1) A PCIE anonn 


OBAS1DGA DFEG FSTSW AX 
aa Fo 
FSTP ST(1) BOPIFCBS 
RE er I BaOOBOOO! 
80893388 d max.B0n93388 
@GA9100F 1.G0A9100F 


ES 0028 32bit B(FFFFFFFF) 
: it BLFFFFFFFF) 
BLFFFFFFFF) 
BLFFFFFFFF) 

TEFDDBOBLFFF) 
it B(FFFFFFFF) 


GGAS1G1F cc INTS a rr Gaaoaaac x ss 
00091020 ps  DDeS EG20A991 FLO QUORD PTR DS: [OA920E0] Last Ert: Sovereee ERROR-SUCCESS 
56 PUSH ESI 00009202 (NO, NB, NE, A, NS, PO, GE, G) 


83EC 18 SUB ESP, 10 i 9 9: 
DDSC24 8 [|FSTP QUÓRD PTR SS:LLOCRL.21 Ao vate aha: oa 
Dogs FLD QUORD PTR DS: [BA92008] M2 empty 8.0 

DD1C24 FSTP QWORD PTR SS:LLOCRL.41 TS empty Bl 

ES Cárrrrrr |CALL B0R3i * 


ui B2A 
BOA9102E 
00A31034 
aan 


MOU ESI, DUORD PTR DS: E<AMSUCRIGO. printf no 


DD5C24 88 — |FSTP QUÓRD PTR SS: [LOCAL.2 Im ding 


Jump is taken empty 


mom om +... sar 


Dest-d mas.88891814 are 
a2 


33090 ai > dx E Bae 1ECeC 40083 3333 
Ban93838| € an à 1 1 4E 58 00/00 00 sol 5 fi a2 a 3: 
AGZ Baaaaoa | E 
EEEE 78|L00A911ED| 4 
Ee GOSIFEGO| GOESÁEGS h 
: 5 ^ F aoz jl Bac 

ERE a B Ba2iFC84 
098 Ba2iFC88 
à : dee. 
2 5 5 5 A ^ a, 20 
GOHSGOEO 0 : : : : Ba2iFCo4 
Ba2iFCo8 

: DOS IFCHO Ba21FC88 

E a21FC 2 8 
EEE B 5 ; Al AA : BG21FCR4| 6FGv94F8|* 
18 BOZIFCAS| BO21FCF4 


Figure 1.80: OllyDbg: TEST is executed 


ZF=0, conditional jump is about to trigger now. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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FSTP ST (or FSTP ST(0)) has been executed —1.2 has been popped from the stack, 
and 3.4 was left on top: 


CPU - main thread, module n  - [nl xl 
P ^ 


DD4424 OC FLD QWORD PTR SS: CARG.3] 
DD4424 84 FLO QWORD PTR SS:CARG.1] 
FCOM ST(1) 

FSTSW AX 

TEST RH,41 

JNZ SHORT 88891814 

Eam ST(C1) 


AS 
' BBR91816 d. 
S bit BLFFFFFFFF) 
t B(FFFFFFFF) 
BLFFFFFFFF) 
BLFFFFFFFF) 
bit 7EFDDOOBLFFF) 

BLFFFFFFFF) 


cc INTS : an pn PRESO 
0005 EG20A90Í FLO QUORD PTR DS: [OA920E0] 00 ERROR SUCCESS 
56 PUSH ESI GE,G) 
83EC 18 SUB ESP, 10 

DOSC24 a9 ^ |FSTP QUÓRD PTR SS:LLOCRL.21 

DDa5 FLO QUORD PTR DS: L8R920D31 

DDiC24 FSTP QWORD PTR $$:CLOCAL.4] 

EB C4FFFFFF | CALL B0h91000 

S635 MOU ESI, DWORD PTR DS: [<&MSUCR100. printf 


pazapa 
H DDSC24 88 FSTP GWORD PTR SS:LLOCRL.21 
Top of stack (@@21FC6G]=d_m. 


Err 
H. 
14 dr 


RETURN from d mas 


I" " 


mmmmmmmmmmmmmmmmT Tnm 


Pointer to next Sly 


Figure 1.81: OllyDbg: FSTP is executed 


We see that the FSTP ST 


instruction works just like popping one value from the FPU stack. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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Second OllyDbg example: a=5.6 and b=-4 


Both FLD are executed: 


CPU - main thread, module d max 


DD4424 ØC FLO QWORD PTR SS: CARG.3] 
DD4424 84 FLD QWORD PTR SS: [ARG.1] 


FCOM ST(1) 

FSTSU AX 

TEST AH, 41 

JNZ SHORT 86A91614 
TP ST(1) 


1008 0091008 
OB2B it B(FFFFFFFF) 

t B(FFFFFFFF) 

; B(FFFFFFFF) 
it B(FFFFFFFF) 
it "EFDDBBBLFFF) 
it B(FFFFFFFF) 


cc INTS stErr 7 S 
DDOS Ea2agoo!FLD QUORD PTR DS: [BA920E0] A Ri Elia 7 
56 PUSH_ESI a J ] 


PE,GE,LE) 
S3EC 18 SUB ESP, 10 
DDSC24 08 FSTP QWORD PTR SS: [LOCAL.2] 
DDOS D220A2AÍ FLO QWORD PTR DS: [BA92008] 
D1C24 FSTP QWORD PTR SS: [LOCAL. 4] 
ES C4FFFFFF | CALL 0A991000 
SB35 MOV ESI, DWORD PTR DS: LC&MSUCR188.printf 


Baeanoot 
DDSC24 68 FSTP QWORD PTR SS:LLOCRL.21 


-4.U0UBOdODODHRDOOUOUODU 
5955999559999996440 
E ond 

a 


Hoo 


RETURN from d mas 


ASCII "pH" 


Figure 1.82: OllyDbg: both FLD are executed 


FCOM is about to execute. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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FCOM has been executed: 


CPU - main thread, module d max 


aanotaaa DD4424 ØC FLO QWORD PTR SS:LRRG.31 
a DD4424 84 FLO QWORD PTR SS:LRRG.11 

DSD1 FCOM ST(1) 

OFEG FSTSU AX 


Serene Z MSUCR100. 6E445617 
TEST AH, 41 al. 
JNZ_SHORT 90991014 ; eA 
FSTP STOD BO IFCBS 
ST E 4 MSUCRIGG. printf 
8 :. 00893388 


66A9166A # . 86A9106A 


S DO2B 32bit BLFFFFFFFF) 
0023 32bit G(FFFFFFFF) 
3 0028 32bit BLFFFFFFFF) 
BOASI ur. 0028 32bit BLFFFFFFFF) 
AE 1 0053 S2bit TEFDDBGBLFFF) 
DORSIGIE S S GG2B 32bit B(FFFFFFFF) 
@BAS1G1F 
0A931020 
29831926 


a 
aan 
aan 
aa 


= 
Gococoooocooo 


DDos EazaRsaI FLO WORD PTR DS: LOAS20E91 Baten ere eee 
56 PUSH ESI ] 88080246 (NO,NB,E, BE, NS, PE, GE, LE) 


83EC 18 SUB ESP, 10 39939995440 
DDSC24 98 — |FSTP GWORD PTR SS:LLOCRL.21 STO valid 5,6299923 Eran 
Does FLD QUORD PTR DS:L8R920D81 SH valid d 
DDiC24 FSTP QUORD PTR SS: (LOCAL. 43 TS empty 

ES C4FFFFFF | CALL BBh91 7 ty 

8B35 FOU EST DUORD PTR DS: [<EMSUCRIGO. printf empty 
DD5C24 88 P_QUÓRD PTR $$:CLOCAL.2] 


FST23000 ES C2=0 CI=0 CO- 
AX=0009 


nn 


- >, 
HIX hNX 


ai 
00A930E0| à 
san3saca| g OODOBBBS 
0000900a 


aanssaFa 
EEE a 0 : a a 3 DE? [Pointer to next Sly 


Figure 1.83: OllyDbg: FCOM is finished 


All conditional flags are cleared. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


FNSTSW done, AX=0x3000: 


CPU - main thread, module d max 


aano9iaaa|rs DD4424 OC FLD QWORD PTR SS: [ARG.3] 
00A91004 DD4424 04 FLD QWORD PTR SS: CARG. 1] 
os01 FCOM ST(1) 


EE MSUCR100,6E445617 


"Zr - | "m Es GOGFDE7S 
JNZ SHORT 90991014 BEEN 

BBR31811 STP ST(1) EBP 0021FCES 

88891013 C3 ESI 6E445584 MSUCRIO0. printf 

EDI 88093388 d max.00893388 


EIP 00A9100C d ma«s.88R9188C 


| S2bit O(FFFFFFFF) 
32bit BLFFFFFFFF) 
S2bit B(FFFFFFFF) 
S2bit BLFFFFFFFF) 
32bit vEFDDBBaLFFF) 
32bit BLFFFFFFFF) 


CC INT3 m p 
DOGS EAZAASAI FLO GWORD PTR DS: [OA920E9] Last ENI HORDEO ERROR-SUCCESS 
56 PUSH ESI 00000246 (NO,NB,E,BE,NS,PE, GE, LE) 


83EC 10 SUB ESP,18 i 
t : valid 5.5999999999999996440 
DOSt24 ao . | ESTP_QUÓRO PTR ES: CLOCAL.2] valid -4.GGübDOOOODDOOOUOUOOOO 


OO-oOr Duo 
Qs 


0A991020 
0A991026 
0A921027 
BOA91D2A 
BOA91DZE 
aanot 

00A91037 
BOA91B3C 
0A991042 


FLD GUORD PTR DS: COA920DS] S empty 0.0 
DD1C24 FSTP QWORD PTR $S:CLOCAL. 43 Soto 

EB C4FFFFFF |CALL 40A91008 , 4 empty 
MOU ESI,DUORD PTR DS: [<&MSUCRIOG. printf 


8B35 empty 
DDSC24 08 FSTP_QUORD PTR SS: [LOCAL. 21 ... ST6 empty 


empty 


mom om om m n n n dr 


2 1G ESP 0 

3000 66 Eró60000 
Prec NEAR,53_ Mask 1 1 

OOA91008 d_max.96A91008 


u 
B 
1 
1 


— 666 
panao ü 40166666! f 
0A993020 5 a : a 8 ;974-F E 9008008 


3 ; CO100000 
8093030 E: 8 H(X hNX ooz1FC74|| Gaaaaoo1 


Q0H22040 @B21FC7S ata |RETURN from d max 
Ba21FCTC 8 

Ba21FCa8 a} hNx |RSCII "px" 
Ba21FC84 HCX 

Ba21FC88 (C583 
Ba21FCBC 


Al SIER 
0021FC90 
aanssaBa 
aanssaca BO21FC94 


Ba21FC98 

PEE OB21FCOC 

c AES 

aanssina 5 a OO OC 2 Ci : ] 
21FC 2 t : " 

90093114 9621 pa 1 t Pointer to next Sg 


Figure 1.84: OllyDbg: FNSTSW has been executed 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


TEST has been executed: 


DD4424 OC [FLD QUORD PTR SS: CARG. 31 EESTREEERELEE 
4||* Db4424 84 | FLD GUORD PTR SS:LHRG.11 TR 
neon: BEDS EE ee M 6E445617 MSUCRIBB. 6E445617 
FERESE TEST AH, 41 i Era 
|-«rz5.e8 |JNZ SHORT 00A910 WEE ESP gosirceo 
Ba21FCBS 
6E445584 MSUCRIBD.printf 
80093388 d maw.00895389 


GGA91GGF d_max.GGA91G6F 


32bit BtFFFFFFFF) 
32bit BLFFFFFFFF) 
B2bit BLFFFFFFFF) 
32bit BLFFFFFFFF) 

3 32bit TEFDDOBB(FFF) 
32bit G(FFFFFFFF) 


96690086 ERROR SUCCESS 
Pl 00000246 (NO,NB,E,BE,NS,PE,GE,LE) 

83bEC 10 SUB ESP, 18 E ' 

DDSC24 08 p| ESTP GORD PTR SS: CLOCRL. 2I Valid Ca aecee00000000000000 

DD1C24 FSTP QWORD PTR SS: LOCAL. 4] FE 

ES C4FFFFFF |CALL 99A91000 empt: 

8B35 AB2BRIGI NOU ESI, DWORD PTR DS:L«STSUCRIOB. printf plat 

DOSC24 88 ^ |FSTP QUÓRD PTR SS: [LOCAL. 2] ss Fic. 


empty 


cc INT3 
ODES ES20090t FLO GWORD PTR DS: [GA920E0] 
56 USH ESI 


5 


Jump is not taken 321 
Dest=d_max . BØR 8000 Cond 0 8 ð 
ü27F Prec NEAR, S3 


: 66666666 
a fa 40166666 
: de bes 
HIX ANA Gaaaaoa | 6 
@GA911ED| : RETURN from d mas 
00000001 | 8 
ass4E68| hnx | ASCII "PNK" 
G821FC84 
BO21FCSS 
AAAA 
00000000 
7EFDEGGR 
60000000 
00000000 
Ba21FC88| wet 
6Für94F8| 99. 
gazirCr4 Pointer to next Sly 


Figure 1.85: OllyDbg: TEST has been executed 


ZF=1, jump will not happen now. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


315 
FSTP ST(1) has been executed: a value of 5.6 is now at the top of the FPU stack. 


CPU - main thread, module d max  - [Bl xl 
^ 


= DD4424 OC [FLD QUORD PTR SS:LHRG.31 
- DD4424 G4 | FLD QUORD PTR SS:CARG.1] 
ECON EL 445617 MSUCR108.6E445617 
TEST RH,41 

JN2 SHORT 00A91014 
FSTP ST(1) 

RETN A. print 


d. . 

EIP 888918013 d mas. 
A Í 
{ 


31013 


A 

FFFFFFFF) 

3M FFFFFFFF) 
atFFFFFFFF) 
atFFFFFFFF) 
7TEFDDaaatFFF) 
atFFFFFFFF) 


HONDO 


cc IN 

DDOS EG200901 FLO QWORD PTR DS: [BA920E0] 

56 PUSH_ESI 

SSEC 18 SUB ESP, 10 

ODSC24 a8 FSTP QWORD PTR SS: [LOCAL. 2] 

DDOS FLO QWORD PTR DS: [0A920081] 

DD1C24 FSTP QWORD PTR SS: [LOCAL. 4] 

ES C4FFFFFF | CALL 96A91000 

SB35 BO20490t MOV ESI, DWORD PTR DS: [<2MSUCR1G0. printf 
DDSC24 48 FSTP_QWORD PTR SS:CLOCAL.2] 


Top of stack [OB2IFCOUI-d man. DOAS1D69 


eorom om om onm onm n 4 


25 A 
FF FF FF FF FF FF F 
FE FF FF FF 81 


RETURN from d max 
ASCII "pNX" 


Figure 1.86: OllyDbg: FSTP has been executed 


We now see that the FSTP ST(1) instruction works as follows: it leaves what has 
been at the top of the stack, but clears ST(1). 


GCC 4.4.1 


Listing 1.216: GCC 4.4.1 


d max proc near 


b - qword ptr -10h 
a - qword ptr -8 
a first half - dword ptr 8 
a second half = dword ptr 0Ch 
b first half = dword ptr 10h 
b second half = dword ptr 14h 
push ebp 
mov ebp, esp 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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sub esp, 10h 


; put a and b to local stack: 


mov eax, [ebp«a first half] 
mov dword ptr [ebp+a], eax 
mov eax, [ebp+a_ second half] 
mov dword ptr [ebp+a+4], eax 
mov eax, [ebp+b first half] 
mov dword ptr [ebp+b], eax 
mov eax, [ebp+b second half] 
mov dword ptr [ebp+b+4], eax 


; load a and b to FPU stack: 


fld [ebp+a] 
fld [ebp+b] 


; current stack state: ST(0) - b; ST(1) -a 
fxch st(1) ; this instruction swaps ST(1) and ST(0) 


; current stack state: ST(0) - a; ST(1) - b 


fucompp ; compare a and b and pop two values from stack, i.e., a and b 
fnstsw ax ; store FPU status to AX 
sahf ; load SF, ZF, AF, PF, and CF flags state from AH 
setnbe al ; store 1 to AL, if CF=0 and ZF=0 
test al, al ; AL==0 ? 
jz short loc 8048453 ; yes 
fld [ebp+a] 
jmp short locret_8048456 
loc 8048453: 
fld [ebp+b] 
locret 8048456: 
leave 
retn 
d max endp 


FUCOMPP is almost like FCOM, but pops both values from the stack and handles "not- 
a-numbers" differently. 


A bit about not-a-numbers. 


The FPU is able to deal with special values which are not-a-numbers or NaNs. These 
are infinity, result of division by 0, etc. Not-a-numbers can be “quiet” and “signal- 
ing". It is possible to continue to work with "quiet" NaNs, but if one tries to do any 
operation with "signaling" NaNs, an exception is to be raised. 


FCOM raises an exception if any operand is NaN. FUCOM raises an exception only if 
any operand is a signaling NaN (SNaN). 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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The next instruction is SAHF (Store AH into Flags) —this is a rare instruction in code 
not related to the FPU. 8 bits from AH are moved into the lower 8 bits of the CPU 
flags in the following order: 


7 6 4 2 0 


SFZF| AF| PF| CF 


Let's recall that FNSTSW moves the bits that interest us (C3/C2/C0) into AH and they 
are in positions 6, 2, 0 of the AH register: 


2 1 0 


C3 cacica 


In other words, the fnstsw ax / sahf instruction pair moves C3/C2/C0 into ZF, PF 
and CF. 


Now let's also recall the values of C3/C2/C0 in different conditions: 
e If a is greater than b in our example, then C3/C2/C0 are to be set to: 0, O, O. 
e if ais less than b, then the bits are to be set to: 0, O, 1. 
e If a=b, then: 1, 0, O. 


In other words, these states of the CPU flags are possible after three 
FUCOMPP/FNSTSW/SAHF instructions: 


* If a» b, the CPU flags are to be set as: ZF=0, PF=0, CF=0. 
* If a«b, then the flags are to be set as: ZF=0, PF=0, CF=1. 
* And if a=b, then: ZF=1, PF=0, CF=0. 


Depending on the CPU flags and conditions, SETNBE stores 1 or O to AL. It is almost 
the counterpart of JNBE, with the exception that SETcc!6 stores 1 or 0 in AL, but Jcc 
does actually jump or not. SETNBE stores 1 only if CF=0 and ZF=0. If it is not true, O 
is to be stored into AL. 


Only in one case both CF and ZF are 0: if a» b. 


Then 1 is to be stored to AL, the subsequent JZ is not to be triggered and the function 
will return a. In all other cases, _b is to be returned. 


Optimizing GCC 4.4.1 


Listing 1.217: Optimizing GCC 4.4.1 


public d max 


d max proc near 
arg 0 - qword ptr 8 
arg 8 - qword ptr 10h 


push ebp 


116cc is condition code 
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mov ebp, esp 

fld [ebp+arg 0] ; a 

fld [ebpt+arg 8] ; b 
; stack state now: ST(0) = b, ST(1)= a 


fxch st(1) 


; stack state now: ST(0) = a, ST(1) = b 
fucom st(1) ; compare a and b 
fnstsw ax 
sahf 
ja short loc 8048448 


store ST(0) to ST(0) (idle operation), 

; pop value at top of stack, 

; leave b at top 

fstp st 

jmp short loc 804844A 


loc 8048448: 
; store a to ST(1), pop value at top of stack, leave a at top 
fstp st(1) 


loc 804844A: 
pop ebp 
retn 

d max endp 


It is almost the same except that JA is used after SAHF. Actually, conditional jump in- 
structions that check "larger", "lesser" or "equal" for unsigned number comparison 
(these are JA, JAE, JB, JBE, JE/JZ, JNA, JNAE, JNB, JNBE, JNE/JNZ) check only flags 
CF and ZF. 


Let's recall where bits C3/C2/C0 are located in the AH register after the execution 
of FSTSW/FNSTSW: 


6 2 1 0 


C3 C2CICO 


Let's also recall, how the bits from AH are stored into the CPU flags after the execution 
of SAHF: 


7 6 4 2 0 


SFZF AF| PF CF 


After the comparison, the C3 and CO bits are moved into ZF and CF, so the conditional 
jumps are able work after. s triggering if both CF are ZF zero. 


Thereby, the conditional jumps instructions listed here can be used after a FNSTSW/SAHF 
instruction pair. 


Apparently, the FPU C3/C2/C0 status bits were placed there intentionally, to easily 
map them to base CPU flags without additional permutations? 
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GCC 4.8.1 with -03 optimization turned on 


Some new FPU instructions were added in the P6 Intel family!?7. These are FUCOMI 
(compare operands and set flags of the main CPU) and FCMOVcc (works like CMOVcc, 
but on FPU registers). 


Apparently, the maintainers of GCC decided to drop support of pre-P6 Intel CPUs 
(early Pentiums, 80486, etc.). 


And also, the FPU is no longer separate unit in P6 Intel family, so now it is possible 
to modify/check flags of the main CPU from the FPU. 


So what we get is: 


Listing 1.218: Optimizing GCC 4.8.1 


fld QWORD PTR [esp+4] ; load "a" 
fld QWORD PTR [esp+12] ; load "p" 
; STO=b, STl=a 

fxch st(1) 

; STO-a, ST1=b 


; compare "a" and "b" 

fucomi st, st(1) 

; copy ST1 ("b" here) to STO if a<=b 
; leave "a" in STO otherwise 

fcmovbe st, st(1) 

; discard value in ST1 

fstp st(1) 

ret 


Hard to guess why FXCH (swap operands) is here. 


It’s possible to get rid of it easily by swapping the first two FLD instructions or by 
replacing FCMOVBE (below or equal) by FCMOVA (above). Probably it’s a compiler 
inaccuracy. 


So FUCOMI compares ST(0) (a) and ST(1) (5) and then sets some flags in the main 
CPU. FCMOVBE checks the flags and copies ST(1) (b here at the moment) to ST(0) (a 
here) if ST0(a) <= ST1(b). Otherwise (a > b), it leaves a in ST(0). 


The last FSTP leaves ST(0) on top of the stack, discarding the contents of ST(1). 
Let's trace this function in GDB: 


Listing 1.219: Optimizing GCC 4.8.1 and GDB 


dennis@ubuntuvm:~/polygon$ gcc -03 d max.c -o d max -fno-inline 
dennis@ubuntuvm:~/polygon$ gdb d max 
GNU gdb (GDB) 7.6.1-ubuntu 


Reading symbols from /home/dennis/polygon/d max...(no debugging symbols 7 
S found)...done. 

(gdb) b d max 

Breakpoint 1 at 0x80484a0 


lU Starting at Pentium Pro, Pentium-ll, etc. 
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(gdb) run 
Starting program: /home/dennis/polygon/d max 


Breakpoint 1, 0x080484a0 in d max () 

(gdb) ni 

0x080484a4 in d max () 

(gdb) disas $eip 

Dump of assembler code for function d max: 


0x080484a0 «40»: fldl 0x4(%esp) 

=> 0x080484a4 <+4>: fldl Oxc(%esp) 
0x080484a8 <+8>: fxch ?ss t (1) 
0x080484aa «410»: fucomi %st(1),%st 
0x080484ac «412»: fcmovbe %st(1),%st 
0x080484ae <+14>: fstp  *sst(1) 
0x080484b0 «416»: ret 

End of assembler dump. 

(gdb) ni 


0x080484a8 in d max () 
(gdb) info float 
R7: Valid  0x3fff9999999999999800 +1.199999999999999956 
=>R6: Valid | 0x4000d999999999999800 +3.399999999999999911 
R5: Empty — 0x00000000000000000000 
R4: Empty 0x00000000000000000000 
R3: Empty  0x00000000000000000000 
R2: Empty  0x00000000000000000000 
R1: Empty 0x00000000000000000000 
RO: Empty — 0x00000000000000000000 


Status Word: 0x3000 
TOP: 6 
Control Word: 0x037f IM DM ZM OM UM PM 


PC: Extended Precision (64-bits) 
RC: Round to nearest 


Tag Word: OxOfff 
Instruction Pointer: 0x73:0x080484a4 
Operand Pointer: 0x7b: Oxbffff118 
Opcode: 0x0000 

(gdb) ni 


0x080484aa in d max () 
(gdb) info float 
R7: Valid 0x4000d999999999999800 +3.399999999999999911 
=>R6: Valid 0x3fff9999999999999800 +1.199999999999999956 
R5: Empty 0x00000000000000000000 
R4: Empty 0x00000000000000000000 
R3: Empty  0x00000000000000000000 
R2: Empty 30x00000000000000000000 
R1: Empty 0x00000000000000000000 
RO: Empty 0x00000000000000000000 


Status Word: 0x3000 
TOP: 6 
Control Word: 0x037f IM DM ZM OM UM PM 


PC: Extended Precision (64-bits) 
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Tag Word: 
Instruction Pointer: 
Operand Pointer: 
Opcode: 

(gdb) disas $eip 


RC: Round to nearest 


OxOfff 


0x73:0x080484a8 
Ox7b:0xbffff118 


0x0000 


Dump of assembler code for function d max: 


0x080484a0 «402»: 
0x080484a4 «44»: 
0x080484a8 «48»: 
=> 0x080484aa «410»: 
0x080484ac «412»: 


fldl 
fldl 
fxch 


0x4(%esp) 
Oxc(%esp) 
%st(1) 


fucomi %st(1),%st 
fcmovbe %st(1),%st 


0x080484ae <+14>: fstp %st(1) 
0x080484b0 «416»: ret 
End of assembler dump. 
(gdb) ni 
0x080484ac in d max () 
(gdb) info registers 
eax 0x1 1 
ecx Oxbffff1c4 - 1073745468 
edx 0x8048340 134513472 
ebx Oxb7 fb F000 - 1208225792 
esp Oxbf ff f10c Oxbffff10c 
ebp Oxbf ff F128 Oxbffff128 
esi 0x0 0 
edi 0x0 0 
eip 0x80484ac 0x80484ac <d_max+12> 
eflags 0x203 [ CF IF ] 
cs 0x73 115 
SS 0x7b 123 
ds 0x7b 123 
es 0x7b 123 
fs 0x0 0 
gs 0x33 51 
(gdb) ni 


0x080484ae in d max () 


(gdb) info float 
R7 


: Valid | 0x4000d999999999999800 +3.399999999999999911 
=>R6: Valid  0x4000d999999999999800 +3.399999999999999911 


R5: Empty 0x00000000000000000000 
R4: Empty | 0x00000000000000000000 
R3: Empty | 0x00000000000000000000 
R2: Empty | 0x00000000000000000000 
R1: Empty  0x00000000000000000000 
RO: Empty X 0x00000000000000000000 


Status Word: 


Control Word: 


Tag Word: 
Instruction Pointer: 


0x3000 
TOP: 6 

0x037f IM DM ZM OM UM PM 
PC: Extended Precision (64-bits) 
RC: Round to nearest 

OxOf ff 

0x73:0x080484ac 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


322 


Operand Pointer: 0x7b:0xbffff118 
Opcode: 0x0000 

(gdb) disas $eip 

Dump of assembler code for function d max: 


0x080484a0 «40»: fidi 0x4(%esp) 
0x080484a4 <+4>: fldl Oxc(%esp) 
0x080484a8 <+8>: fxch ?ss t (1) 
0x080484aa «410»: fucomi %st(1),%st 
0x080484ac «412»: fcmovbe %st(1),%st 

=> 0x080484ae <+14>: fstp %st(1) 
0x080484b0 <+16>: ret 

End of assembler dump. 

(gdb) ni 


0x080484b0 in d max () 
(gdb) info float 
=>R7: Valid 0x4000d999999999999800 +3.399999999999999911 
R6: Empty 0x4000d999999999999800 
R5: Empty  0x00000000000000000000 
R4: Empty 0x00000000000000000000 
R3: Empty 0x00000000000000000000 
R2: Empty 30x00000000000000000000 
R1: Empty 0x00000000000000000000 
RO: Empty 0x00000000000000000000 


Status Word: 0x3800 
TOP: 7 
Control Word: 0x037f IM DM ZM OM UM PM 


PC: Extended Precision (64-bits) 
RC: Round to nearest 


Tag Word: Ox3fff 
Instruction Pointer: 0x73:0x080484ae 
Operand Pointer: Ox7b:0xbffff118 
Opcode: 0x0000 

(gdb) quit 


A debugging session is active. 
Inferior 1 [process 30194] will be killed. 


Quit anyway? (y or n) y 
dennis@ubuntuvm:~/polygon$ 


Using “ni”, let’s execute the first two FLD instructions. 
Let’s examine the FPU registers (line 33). 


As it was mentioned before, the FPU registers set is a circular buffer rather than a 
stack (1.25.5 on page 283). And GDB doesn’t show STx registers, but internal the 
FPU registers (Rx). The arrow (at line 35) points to the current top of the stack. 


You can also see the TOP register contents in Status Word (line 36-37)—it is 6 now, 
so the stack top is now pointing to internal register 6. 


The values of a and b are swapped after FXCH is executed (line 54). 
FUCOMI is executed (line 83). Let’s see the flags: CF is set (line 95). 
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FCMOVBE has copied the value of b (see line 104). 


FSTP leaves one value at the top of stack (line 139). The value of TOP is now 7, so 
the FPU stack top is pointing to internal register 7. 


ARM 
Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Listing 1.220: Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


VMOV D16, R2, R3 ; b 

VMOV D17, RO, R1; a 

VCMPE. F64 D17, D16 

VMRS APSR_nzcv, FPSCR 

VMOVGT . F64 D16, D17 ; copy "a" to D16 
VMOV RO, R1, D16 

BX LR 


A very simple case. The input values are placed into the D17 and D16 registers and 
then compared using the VCMPE instruction. 


Just like in the x86 coprocessor, the ARM coprocessor has its own status and flags 
register (FPSCRH9), since there is a necessity to store coprocessor-specific flags. 
And just like in x86, there are no conditional jump instruction in ARM, that can check 
bits in the status register of the coprocessor. So there is VMRS, which copies 4 bits 
(N, Z, TAL from the coprocessor status word into bits of the general status register 
(APSRH?), 


VMOVGT is the analog of the MOVGT, instruction for D-registers, it executes if one 
operand is greater than the other while comparing (GT—Greater Than). 


If it gets executed, the value of a is to be written into D16 (that is currently stored in 
D17). Otherwise the value of b stays in the D16 register. 


The penultimate instruction VMOV prepares the value in the D16 register for returning 
it via the RO and R1 register pair. 


Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


Listing 1.221: Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


VMOV D16, R2, R3 ; b 
VMOV D17, RO, R1; a 
VCMPE. F64 D17, D16 

VMRS APSR nzcv, FPSCR 
IT GT 

VMOVGT . F64 D16, D17 

VMOV RO, R1, D16 

BX LR 


118(ARM) Floating-Point Status and Control Register 
119(ARM) Application Program Status Register 
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Almost the same as in the previous example, however slightly different. As we al- 
ready know, many instructions in ARM mode can be supplemented by condition 
predicate. But there is no such thing in Thumb mode. There is no space in the 16-bit 
instructions for 4 more bits in which conditions can be encoded. 


However, Thumb-2 was extended to make it possible to specify predicates to old 
Thumb instructions. Here, in the IDA-generated listing, we see the VMOVGT instruc- 
tion, as in previous example. 


In fact, the usual VMOV is encoded there, but IDA adds the -GT suffix to it, since there 
is a IT GT instruction placed right before it. 


The IT instruction defines a so-called if-then block. 


After the instruction it is possible to place up to 4 instructions, each of them has 
a predicate suffix. In our example, IT GT implies that the next instruction is to be 
executed, if the GT (Greater Than) condition is true. 


Here is a more complex code fragment, by the way, from Angry Birds (for iOS): 


Listing 1.222: Angry Birds Classic 


ITE NE 


VMOVNE R2, R3, D16 
VMOVEQ R2, R3, D17 


BLX  objc msgSend ; not suffixed 


ITE stands for if-then-else 
and it encodes suffixes for the next two instructions. 


The first instruction executes if the condition encoded in ITE (NE, not equal) is true 
at, and the second—if the condition is not true. (The inverse condition of NE is EQ 
(equal)). 


The instruction followed after the second VMOV (or VMOVEQ) is a normal one, not suf- 
fixed (BLX). 


One more that's slightly harder, which is also from Angry Birds: 


Listing 1.223: Angry Birds Classic 


ITTTT EQ 


MOVEQ RO, R4 

ADDEQ SP, SP, #0x20 
POPEQ.W {R8,R10} 
POPEQ {R4-R7, PC} 


BLX ___stack_chk_ fail ; not suffixed 


Four “T” symbols in the instruction mnemonic mean that the four subsequent in- 
structions are to be executed if the condition is true. 


That’s why IDA adds the -EQ suffix to each one of them. 
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And if there was, for example, ITEEE EQ (if-then-else-else-else), then the suffixes 
would have been set as follows: 


-EQ 
-NE 
-NE 
-NE 


Another fragment from Angry Birds: 


Listing 1.224: Angry Birds Classic 


CMP.W RO, ZOxFFFFFFFF 


ITTE LE 

SUBLE.W R10, RO, #1 

NEGLE RO, RO 

MOVGT R10, RO 

MOVS Re, #0 ; not suffixed 


CBZ RO, loc 1E7E32 ; not suffixed 


ITTE (if-then-then-else) 


implies that the 1st and 2nd instructions are to be executed if the LE (Less or Equal) 
condition is true, and the 3rd—if the inverse condition (GT—Greater Than) is true. 


Compilers usually don't generate all possible combinations. 


For example, in the mentioned Angry Birds game (classic version for iOS) only these 
variants of the IT instruction are used: IT, ITE, ITT, ITTE, ITTT, ITTTT. How to learn 
this? In IDA, it is possible to produce listing files, so it was created with an option to 
show 4 bytes for each opcode. Then, knowing the high part of the 16-bit opcode (IT 
is OXBF), we do the following using grep: 


cat AngryBirdsClassic.lst | grep " BF" | grep "IT" > results.lst 


By the way, if you program in ARM assembly language manually for Thumb-2 mode, 
and you add conditional suffixes, the assembler will add the IT instructions automat- 
ically with the required flags where it is necessary. 


Non-optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Listing 1.225: Non-optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


b - -0x20 

a - -0x18 

val to return  - -0x10 

saved R7 = -4 
STR R7, [SP,#saved R7]! 
MOV R7, SP 
SUB SP, SP, #0x1C 
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BIC SP, SP, #7 

VMOV D16, R2, R3 

VMOV D17, RO, R1 

VSTR D17, [SP,#0x20+a] 

VSTR D16, [SP,#0x20+b] 

VLDR D16, [SP,#0x20+a] 

VLDR D17, [SP,#0x20+b] 

VCMPE.F64 D16, D17 

VMRS APSR nzcv, FPSCR 

BLE loc 2bE08 

VLDR D16, [SP,#0x20+a] 

VSTR D16, [SP,40x20-val to return] 

B loc 2bE10 
loc 2bE08 

VLDR D16, [SP,#0x20+b] 

VSTR D16, [SP,*0x20+val_to return] 
loc 2bE10 

VLDR D16, [SP,40x20-val to return] 

VMOV RO, R1, D16 

MOV SP, R7 

LDR R7, [SP+0x20+b] ,#4 

BX LR 


Almost the same as we already saw, but there is too much redundant code because 
the a and b variables are stored in the local stack, as well as the return value. 


Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.226: Optimizing Keil 6/2013 (Thumb mode) 


loc_1C0 


{R3-R7,LR} 

R4, R2 

R5, R3 

R6, RO 

R7, R1 

. aeabi cdrcmple 
loc 1C0 

RO, R6 

R1, R7 
{R3-R7,PC} 


RO, R4 
R1, R5 
(R3-R7,PC] 


Keil doesn't generate FPU-instructions since it cannot rely on them being supported 
on the target CPU, and it cannot be done by straightforward bitwise comparing. So 
it calls an external library function to do the comparison: . aeabi cdrcmple. 
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N.B. The result of the comparison is to be left in the flags by this function, so the 
following BCS (Carry set—Greater than or equal) instruction can work without any 
additional code. 


ARM64 
Optimizing GCC (Linaro) 4.9 


d max: 
; DO - a, D1 - b 

fcmpe d0, dl 

fcsel dQ, dO, dl, gt 
; now result in DO 

ret 


The ARM64 ISA has FPU-instructions which set APSR the CPU flags instead of FPSCR 
for convenience. TheFPU is not a separate device here anymore (at least, logically). 
Here we see FCMPE. It compares the two values passed in DO and D1 (which are the 
first and second arguments of the function) and sets APSR flags (N, Z, C, V). 


FCSEL (Floating Conditional Select) copies the value of DO or D1 into DO depending on 
the condition (GT—Greater Than), and again, it uses flags in APSR register instead 
of FPSCR. 


This is much more convenient, compared to the instruction set in older CPUs. 


If the condition is true (GT), then the value of DO is copied into DO (i.e., nothing 
happens). If the condition is not true, the value of D1 is copied into DO. 


Non-optimizing GCC (Linaro) 4.9 


d max: 

; save input arguments in "Register Save Area" 
sub sp, sp, £16 
str d0, [sp,8] 
str dl, [sp] 


; reload values 
ldr X1, [sp,8] 
ldr x0, [sp] 
fmov do, x1 
fmov dl, x0 

; DO - a, D1 -b 
fcmpe d0, dl 
ble .L76 

; a>b; load DO (a) into X0 
ldr x0, [sp,8] 
b .L74 

.L76: 

; a«-b; load D1 (b) into X0 
ldr x0, [sp] 

.L74: 
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; result in X0 
fmov dO, x0 

; result in DO 
add sp, sp, 16 
ret 


Non-optimizing GCC is more verbose. 


First, the function saves its input argument values in the local stack (Register Save 
Area). Then the code reloads these values into registers X0/X1 and finally copies 
them to D0/D1 to be compared using FCMPE. A lot of redundant code, but that is how 
non-optimizing compilers work. FCMPE compares the values and sets the APSR flags. 
At this moment, the compiler is not thinking yet about the more convenient FCSEL 
instruction, so it proceed using old methods: using the BLE instruction (Branch if 
Less than or Equal). In the first case (a > b), the value of a gets loaded into X0. In the 
other case (a <= b), the value of b gets loaded into X0. Finally, the value from X0 gets 
copied into DO, because the return value needs to be in this register. 


Exercise 


As an exercise, you can try optimizing this piece of code manually by removing 
redundant instructions and not introducing new ones (including FCSEL). 


Optimizing GCC (Linaro) 4.9—float 


Let's also rewrite this example to use float instead of double. 


float f max (float a, float b) 


1 
if (a»b) 
return a; 
return b; 
E 
f max: 


; SQ - a, S1 -b 

fcmpe s0, sl 

fcsel  s0, sO, sl, gt 
; now result in SO 

ret 


It is the same code, but the S-registers are used instead of D- ones. It’s because 
numbers of type float are passed in 32-bit S-registers (which are in fact the lower 
parts of the 64-bit D-registers). 
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MIPS 


The co-processor of the MIPS processor has a condition bit which can be set in the 
FPU and checked in the CPU. 


Earlier MIPS-es have only one condition bit (called FCCO), later ones have 8 (called 
FCC7-FCCO). 


This bit (or bits) are located in the register called FCCR. 
Listing 1.227: Optimizing GCC 4.4.5 (IDA) 


d max: 
; set FPU condition bit if $f14«$f12 (b«a): 
c.lt.d $f14, $f12 
or $at, $zero ; NOP 
; jump to locret 14 if condition bit is set 
belt locret_14 
this instruction is always executed (set return value to "a"): 
mov.d $f0, $f12 ; branch delay slot 
this instruction is executed only if branch was not taken 
; (i.e., if b>=a) 
; set return value to "b": 
mov.d $f0, $f14 


locret 14: 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


C.LT.D compares two values. LT is the condition “Less Than”. D implies values of 
type double. Depending on the result of the comparison, the FCCO condition bit is 
either set or cleared. 


BC1T checks the FCCO bit and jumps if the bit is set. T means that the jump is to be 
taken if the bit is set ("True"). There is also the instruction BC1F which jumps if the 
bit is cleared ("False"). 


Depending on the jump, one of function arguments is placed into $FO. 


1.25.8 Some constants 


It's easy to find representations of some constants in Wikipedia for IEEE 754 encoded 
numbers. It's interesting to know that 0.0 in IEEE 754 is represented as 32 zero bits 
(for single precision) or 64 zero bits (for double). So in order to set a floating point 
variable to 0.0 in register or memory, one can use MOV or XOR reg, reg instruction. 
This is suitable for structures where many variables present of various data types. 
With usual memset() function one can set all integer variables to 0, all boolean vari- 
ables to false, all pointers to NULL, and all floating point variables (of any precision) 
to 0.0. 
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1.25.9 Copying 


One may think inertially that FLD/FST instructions must be used to load and store 
(and hence, copy) IEEE 754 values. Nevertheless, same can be achieved easier by 
usual MOV instruction, which, of course, copies values bitwisely. 


1.25.10 Stack, calculators and reverse Polish notation 


Now we understand why some old programmable calculators use reverse Polish no- 
tation. 


For example, for addition of 12 and 34 one has to enter 12, then 34, then press "plus" 
sign. 


It's because old calculators were just stack machine implementations, and this was 
much simpler than to handle complex parenthesized expressions. 


Such a calculator still present in many Unix distributions: dc. 


1.25.11 80 bits? 


Internal numbers representation in FPU — 80-bit. Strange number, because the 
number not in 2” form. There is a hypothesis that this is probably due to historical 
reasons—the standard IBM punched card can encode 12 rows of 80 bits. 80-25 text 
mode resolution was also popular in past. 


Wikipedia has another explanation: https://en.wikipedia.org/wiki/Extended 
precision. 


If you know better, please a drop email to the author: my emails. 


1.25.12 x64 


On how floating point numbers are processed in x86-64, read more here: 1.38 on 
page 541. 


1.25.13 Exercises 


* http://challenges.re/60 
* http://challenges.re/61 


1.26 Arrays 


An array is just a set of variables in memory that lie next to each other and that have 
the same type??°.yy ??1 


120AKA "homogeneous container" 
121AKA "homogener Container". 
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1.26.1 Simple example 


#include <stdio.h> 


int main() 

{ 
int a[20]; 
int i; 


for (i20; i<20; i++) 
a[i]2-i*2; 


for (i20; i<20; i++) 
printf ("a[%d]=%d\n", i, a[il); 


return 0; 


ur 


x86 
MSVC 


Let's compile: 


Listing 1.228: MSVC 2008 


TEXT SEGMENT 


i$ - -84 ; size = 4 
_a$ = -80 ; size = 80 
_Main PROC 

push ebp 

mov ebp, esp 

sub esp, 84 ; 00000054H 

mov DWORD PTR i$[ebp], © 

jmp SHORT $LN6@main 
$LN5@main: 

mov eax, DWORD PTR i$[ebp] 

add eax, 1 

mov DWORD PTR i$[ebp], eax 
$LN6@main: 

cmp DWORD PTR i$[ebp], 20 ; 00000014H 


jge SHORT $LN4@main 

mov ecx, DWORD PTR i$[ebp] 

shl ecx, 1 

mov edx, DWORD PTR _i$[ebp] 

mov DWORD PTR _a$[ebp+edx*4], ecx 

jmp SHORT $LN5@main 
$LN4@main: 

mov DWORD PTR i$[ebp], 0 

jmp SHORT $LN3@main 
$LN2@main: 

mov eax, DWORD PTR i$[ebp] 
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add 
mov 


$LN3@main: 


cmp 
jge 
mov 
mov 
push 
mov 
push 
push 
call 
add 


jmp 


$LN1@main: 


xor 
mov 
pop 
ret 
main 


eax, 1 
DWORD PTR i$[ebp], eax 


DWORD PTR i$[ebp], 20 ; 00000014H 
SHORT $LNlcmain 

ecx, DWORD PTR i$[ebp] 

edx, DWORD PTR _a$[ebp+ecx*4] 
edx 

eax, DWORD PTR i$[ebp] 

eax 

OFFSET $SG2463 

| printf 

esp, 12 ; 0000000cH 
SHORT $LN2@main 


eax, eax 
esp, ebp 
ebp 

0 

ENDP 


Nothing very special, just two loops: the first is a filling loop and second is a printing 
loop. The shl ecx, 1 instruction is used for value multiplication by 2 in ECX, more 
about it: 1.24.2 on page 274. 


80 bytes are allocated on the stack for the array, 20 elements of 4 bytes. 
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Let's try this example in OllyDbg. 


We see how the array gets filled: 


each element is 32-bit word of int type and its value is the index multiplied by 2: 


Torn 


Oa 


000 


t 


Imm-a 
Stack [@G1SFEFG]=69000014 (decimal 
Jump from 48181C 


MOU DWO 


gogoagaz 
0000001 
gogogo 
> BBISFEFO 
' Ba18FF44 
90000001 
10403380 


a040182C 


ELOCRL. 211 


LOCAL. 211, EAX 
LOCRL.211,14 


ELOCRL.213 


LLOCRL. 211 
WK*4-EBP-561, ECX 


CRL.211,8 
SS: CLOCAL.21] 


¿EL L.211J,ERX 
LOCRL.211,14 


ONDIO m mrmmrmmrnr 


COGG-OGr-(G T AN 


CLOCAL. 211 
TECX*4+EBP-50] 


veo r 


S: LOCAL. 21] 


Lx 6er well 


No a 


ters P 
; aaaanat4 


t B(FFFFFFFF) 
BLFFFFFFFF) 
; rEFDDaaatFFF) 
at FFFFFFFF) 
| SUCCESS 
PE, GE, LE) 
ESPU 
Dop 


34 wz +0 


r+ 


RETURN from s 


Figure 1.87: OllyDbg: after array filling 


Since this array is located in the stack, we can see all its 20 elements there. 


GCC 


Here is what GCC 4.4.1 does: 


Listing 1.229: GCC 4.4.1 


main 


public main 
proc near 


; DATA XREF: _start+17 
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var 70 - dword ptr -70h 
var 6C - dword ptr -6Ch 
var 68 = dword ptr -68h 
i2 = dword ptr -54h 
i - dword ptr -4 
push ebp 
mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 70h 
mov [esp+70h+i], 0 ; 1=0 
jmp short loc 804840A 
loc 80483F7: 
mov eax, [esp+70h+i] 
mov edx, [esp+70h+i] 
add edx, edx ; edx=i*2 
mov [espteax*4+70h+i 2], edx 
add [esp+70h+i], 1 ; i++ 
loc 804840A: 
cmp [esp+70h+i1, 13h 
jle short loc_80483F7 
mov [esp+70h+i], 0 
jmp short loc_8048441 
loc 804841B: 
mov eax, [esp+70h+i] 
mov edx, [esp+eax*4+70h+i 2] 
mov eax, offset aADD ; “al%d]=%d\n" 
mov [esp*-70h-var 68], edx 
mov edx, [esp+70h+i] 
mov [esp*-70h-var 6C], edx 
mov [esp+70h+var_ 70], eax 
call _ printf 
add [esp+70h+i], 1 
loc_8048441: 
cmp [esp+70h+i1, 13h 
jle short loc 804841B 
mov eax, 0 
leave 
retn 
main endp 


By the way, variable a is of type int* (the pointer to int)—you can pass a pointer to 
an array to another function, but it's more correct to say that a pointer to the first 
element of the array is passed (the addresses of rest of the elements are calculated 


in an obvious way). 


If you index this pointer as a[idx], idx is just to be added to the pointer and the 


element placed there (to which calculated pointer is pointing) is to be returned. 
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An interesting example: a string of characters like string is an array of characters 
and it has a type of const char[]. 


An index can also be applied to this pointer. 


And that is why it is possible to write things like “string” [i]—this is a correct C/C++ 
expression! 


ARM 
Non-optimizing Keil 6/2013 (ARM mode) 


EXPORT main 


main 
STMFD . SP!, {R4,LR} 
SUB SP, SP, #0x50 ; allocate place for 20 int variables 
; first loop 
MOV R4, #0 PO 
B loc 4A0 
loc 494 
MOV RO, R4,LSL#1 ; RO=R4*2 
STR RO, [SP,R4,LSL#2]; store RO to SP+R4<<2 (same as SP+R4*4) 
ADD R4, R4, #1 ; i=i+l 
loc 4A0 
CMP R4, #20 ; i«20? 
BLT loc 494 ; yes, run loop body again 


; Second loop 


MOV R4, #0 si 
B loc_4C4 
loc_4B0 
LDR R2, [SP,R4,LSL#2]; (second printf argument) 
R2=* (SP+R4<<4) (same as *(SP+R4*4)) 
MOV R1, R4 ; (first printf argument) Rl=i 
ADR RO, aADD ; "a[%d]=%d\n" 
BL . 2printf 
ADD R4, R4, #1 ; i-i41 
loc 4C4 
CMP R4, #20 ; 1<20? 
BLT loc 4B0 ; yes, run loop body again 
MOV RO, #0 ; value to return 
ADD SP, SP, 40x50 ; deallocate chunk, allocated for 20 int 
variables 


LDMFD — SP!, {R4,PC} 


int type requires 32 bits for storage (or 4 bytes), 


so to store 20 int variables 80 (0x50) bytes are needed. So that is why the SUB SP, 
SP, 40x50 
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instruction in the function's prologue allocates exactly this amount of space in the 
stack. 


In both the first and second loops, the loop iterator i is placed in the R4 register. 


The number that is to be written into the array is calculated as i«2, which is effectively 
equivalent to shifting it left by one bit, 
so MOV RO, R4,LSL#1 instruction does this. 


STR RO, [SP,R4,LSL#2] writes the contents of RO into the array. 


Here is how a pointer to array element is calculated: SP points to the start of the 
array, R4 is i. 


So shifting i left by 2 bits is effectively equivalent to multiplication by 4 (since each 
array element has a size of 4 bytes) and then it's added to the address of the start 
of the array. 


The second loop has an inverse LDR R2, [SP,R4,LSL#2] instruction. It loads the 
value we need from the array, and the pointer to it is calculated likewise. 


Optimizing Keil 6/2013 (Thumb mode) 


main 
PUSH {R4,R5,LR} 
; allocate place for 20 int variables + one more variable 


SUB SP, SP, #0x54 
; first loop 
MOVS RO, #0 X 
MOV R5, SP ; pointer to first array element 


loc 1CE 
LSLS R1, RO, #1 
LSLS R2, RO, #2 


Rl=i<<1 (same as i*2) 
R2=i<<2 (same as i*4) 


ADDS RO, RO, Z1 ; i=i+l 

CMP RO, 420 ; i«20? 

STR R1, [R5,R2] ; store R1 to *(R5+R2) (same R5+i*4) 
BLT loc 1CE ; yes, i«20, run loop body again 


; Second loop 


; value to return 


MOVS R4, #0 ; i-0 
loc 1DC 
LSLS RO, R4, #2 ; RO=i<<2 (same as i*4) 
LDR R2, [R5,R0] ; load from *(R5+RO) (same as R5+i*4) 
MOVS R1, R4 
ADR RO, aADD ; "al%d]=%d\n" 
BL . 2printf 
ADDS RA, R4, #1 ; i=i+1 
CMP R4, 420 ; i«20? 
BLT loc 1DC ; yes, i«20, run loop body again 


MOVS RO, #0 
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; deallocate chunk, allocated for 20 int variables 
; + one more variable 

ADD SP, SP, #0x54 

POP (RA,R5,PC) 


Thumb code is very similar. 


Thumb mode has special instructions for bit shifting (like LSLS), which calculates the 
value to be written into the array and the address of each element in the array as 
well. 


The compiler allocates slightly more space in the local stack, however, the last 4 
bytes are not used. 


Non-optimizing GCC 4.9.1 (ARM64) 


Listing 1.230: Non-optimizing GCC 4.9.1 (ARM64) 


.LC0: 
.string "“a[%d]=%d\n" 
main: 
; save FP and LR in stack frame: 
stp x29, x30, [sp, -112]! 
; set stack frame (FP=SP) 
add x29, sp, 0 


; setting initial counter variable at 0 
; (WZR is the register always holding zero): 


str wzr, [x29,108] 
; jump to loop condition checking code: 
b .L2 


.L3: 

; load value of "i" variable: 
ldr w0, [x29,108] 

multiplicate it by 2: 


Isl w2, w0, 1 
; find a place of an array in local stack: 
add x0, x29, 24 


load 32-bit integer from local stack and sign extend it to 64-bit one: 
ldrsw x1, [x29,108] 
calculate address of element (X0+X1<<2=array address+i*4) 
; and store W2 (i*2) there: 
str w2, [x0,x1,lsl 2] 
increment counter (i): 
ldr w0, [x29,108] 
add w0, w0, 1 
str w0, [x29,108] 


.L2: 
; check if we finished: 
ldr w0, [x29,108] 


cmp w0, 19 
; jump to L3 (loop body begin) if not: 
ble .L3 


; second part of the function begins here. 
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; setting initial counter variable at 0. 
; by the way, the same place in the local stack was used for counter, 
; because the same local variable (i) is being used as counter. 


str wzr, [x29,108] 
b .L4 

¿15 

; Calculate array address: 
add x0, x29, 24 


; load "i" value: 
ldrsw x1, [x29,108] 
; load value from the array at the address (X0+X1<<2 = address of array + 
i*4 
ligy w2, [x0,x1,lsl 2] 
; load address of the "a[%d]=%d\n" string: 
adrp x0, .LCO 
add x0, x0, :1012:.LC0 
; load "i" variable to W1 and pass it to printf() as second argument: 
ldr wl, [x29,108] 

; W2 still contains the value of array element which was just loaded. 
; call printf(): 

bl printf 
increment "i" variable: 

ldr w0, [x29,108] 

add w0, wO, 1 

str w0, [x29,108] 


.L4: 
; are we finished? 
ldr w0, [x29,108] 


cmp w0, 19 

; jump to the loop body begin if not: 
ble .L5 

; return 0 
mov w0, 0 

; restore FP and LR: 
ldp x29, x30, [sp], 112 
ret 


MIPS 


The function uses a lot of S- registers which must be preserved, so that's why its 
values are saved in the function prologue and restored in the epilogue. 


Listing 1.231: Optimizing GCC 4.4.5 (IDA) 


main: 

var 70 - -0x70 
var 68 = -0x68 
var 14 = -0x14 
var_10 = -0x10 
var_C = -0xC 
var 8 = -8 
var 4 = -4 
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; function prologue: 


lui $9p, 
addiu $sp, 
la $9p, 
SW $ra, 
sw $53, 
SW $s2, 
SW $s1, 
SW $s0, 
SW $9p, 
addiu $s1, 
move $v1, 


move $v0, 
; that value will be used as 
; it was precalculated by GCC 


li $a0, 
loc 34: 
; Store value into memory: 
SW $v0, 
; increase value to be stored 
addiu $v0, 
; loop terminator reached? 
bne $v0, 
; add 4 to address anyway: 
addiu $v1, 


array filling loop is ended 
second loop begin 


la $s3, 
; "i" variable will reside in 
move $s0, 
li $s2, 
loc 54: 
; call printf(): 
lw $t9, 


lw $a2, 
move $al, 
move $a0, 
jalr $t9 
; increment "i": 
addiu X $s0, 
lw $9p, 
; jump to Loop body if end is 
bne $s0, 
; move memory pointer to the 
addiu  $sl, 
; function epilogue 
lw $ra, 
move $v0, 
lw $s3, 
lw $s2, 
lw $s1, 


(  gnu local gp >> 16) 
-0x80 

( gnu local gp € OxFFFF) 

0x80-var 4($sp) 

0x80-var 8($sp) 

0x80-var C($sp) 

0x80-var 10($sp) 

0x80-var 14($sp) 

0x80-var 70($sp) 

$sp, 0x80+var_68 

$s1 

$zero 

a loop terminator. 
compiler at compile stage: 

028 # '(' 


# CODE XREF: main+3C 


0($v1) 
by 2 at each iteration: 
2 


$a0, loc 34 


4 


$LCO # "a[l%d]=%d\n" 
$s0: 
$zero 
0x14 


# CODE XREF: main+70 


(printf & OxFFFF) ($gp) 
0($s1) 

$s0 

$s3 


1 

0x80-var 70($sp) 
not reached: 

$s2, loc 54 

next 32-bit word: 

4 


0x80-var 4($sp) 
$zero 

0x80-var 8($sp) 
0x80-var C($sp) 
0x80-var 10($sp) 
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lw $s0, Ox80+var_14($sp) 
jr $ra 
addiu $sp, 0x80 


$LCO: .ascii "a[?sd]-9*sdXn" «0» # DATA XREF: main+44 


Something interesting: there are two loops and the first one doesn't need i, it needs 
only i«2 (increased by 2 at each iteration) and also the address in memory (increased 
by 4 at each iteration). 


So here we see two variables, one (in $VO) increasing by 2 each time, and another 
(in $V1) — by 4. 


The second loop is where printf() is called and it reports the value of i to the user, 
so there is a variable which is increased by 1 each time (in $S0) and also a memory 
address (in $S1) increased by 4 each time. 


That reminds us of loop optimizations: 3.10 on page 612. 


Their goal is to get rid of multiplications. 


1.26.2 Buffer overflow 
Reading outside array bounds 


So, array indexing is just array[index]. If you study the generated code closely, 
you'll probably note the missing index bounds checking, which could check if it is 
less than 20. What if the index is 20 or greater? That's the one C/C++ feature it is 
often blamed for. 


Here is a code that successfully compiles and works: 


#include <stdio.h> 


int main() 

{ 
int a[20]; 
int i; 


for (i=0; i<20; i++) 
a[li]=i*2; 


printf ("a[20]=%d\n", a[20]); 


return 0; 


E 


Compilation results (MSVC 2008): 
Listing 1.232: Non-optimizing MSVC 2008 


$5G2474 DB 'a[201=%d', OaH, OOH 


i$ = -84 ; size = 4 
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_a$ = -80 ; size = 80 


_Main PROC 
push ebp 
mov ebp, esp 
sub esp, 84 
mov DWORD PTR i$[ebp], 0 


jmp SHORT $LN3@main 
$LN2@main: 
mov eax, DWORD PTR i$[ebp] 
add eax, 1 
mov DWORD PTR i$[ebp], eax 
$LN3@main: 
cmp DWORD PTR _i$[ebp], 20 
jge SHORT $LNl1@main 
mov ecx, DWORD PTR i$[ebp] 
shl ecx, 1 
mov edx, DWORD PTR _i$[ebp] 
mov DWORD PTR _a$[ebp+edx*4], ecx 
jmp SHORT $LN2@main 
$LN1@main: 
mov eax, DWORD PTR _a$[ebp+80] 
push eax 
push OFFSET $SG2474 ; ‘a[20]=%d' 
call DWORD PTR imp printf 
add esp, 8 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 
main ENDP 
_ TEXT ENDS 
END 


The code produced this result: 


Listing 1.233: OllyDbg: console output 


a[20]=1638280 


It is just something that has been lying in the stack near to the array, 80 bytes away 
from its first element. 
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Let's try to find out where did this value come from, using OllyDbg. 


Let's load and find the value located right after the last array element: 


CPU - main thread, module r 


$ 55 PUSH EBP zx = 
SBEC MOU EBP, ESP Haters LEEW 


S8EC 54 SUB ESP, 54 C5 BRBBBEASE 
C745 AC 68801 MOU DWORD PTR SS: [LOCAL.211,8 ATTE 
EB 09 JMP SHORT 96401018 ó 5 
8B45 AC OY EAX, DWORD PTR SS:LLOCRL.211 

saca 81 EAX, 1 

8945 AC DWORD PTR SS:LLOCRL.211,ERX 
8370 AC 14 DWORD PTR SS: CLOCAL. 211,14 
7D BE SHORT aa4giüec 

ECX, DWORD PTR 55: ELOCAL. 213 


EDX, DWORD PTR SS:CLOCAL.21] 
DWORD PTR SS:LEDX*4*EBP-5801, ECX 
SHORT 6040100F 
EAX, DWORD PTR SS: [LOCAL. 0] 
5a PUSH EAX 
68 66304006 | PUSH OFFSET 00403008 
FF15 AG204001 CALL DWORD PTR DS: [<8MSUCR9D. printf >] 
ADD ESP,S8 
XOR EAX, EAX 
MOU ESP, EBP 
POP EBP 
c3 RETN 
68 28144000 | PUSH 00401428 
ES 90636086 |CALL 004013EB 
Al 50304000 |MOU EAX, DWORD PTR DS: [403050] 
424 EL Nou O OD PIR SSC Ora £L.) 


vtt 


< 


@( FFFFFFFF) 
@( FFFFFFFF) 

t B(FFFFFFFF) 
TEFDDBBBtFFF) 
BCFFFFFFFF) 


> 


HONDO 
¡DARDO 


oo 


eer q. .... 


Stack LOBISFFI41=Ó018FFeS 
EAR=-00000014 (decimal 28.) 
Jump from 40101C T Err 


_ Mask 


SPUOZD 


Sew z+ 


v f iqhwftCo 

b f EA“wute p 
(tew 

u$G8 pH” 


ber +a 


RETURN from r. 6641, 


Figure 1.88: OllyDbg: reading of the 20th element and execution of printf() 


What is this? Judging by the stack layout, this is the saved value of the EBP register. 
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Let's trace further and see how it gets restored: 


CPU - main thread, module r 


PUSH EBP 

MOU EBP,ESP 

SUB ESP,54 

MOU DWORD PTR Sot LLOCnE «211,0 
JMP SHORT 964616 

MoU EAX, DUORD PTR SS: [LOCAL.211 


EAX 

DUORD PTR SS: [LOCAL.211,EAX 
DWORD PTR SS:LLOCRL.211,14 
SHORT 6646162C 

ECX, DUORD PTR SS:CLOCAL.21] EIP 80401043 


EDs DuoRD PTR SS: CLOCAL.21] 
894095 Ba DWORD PTR_SS: CEDX*4+EBP-50],ECX 
EB ES JMP SHORT 6646166F 

8B45 00 MOU EAX, DWORD PTR SS: LOCAL. 6] 

5a PUSH EAX 

68 00304000 |PUSH OFFSET 00493008 

FF15 RG28488! CALL DWORD PTR DS: (<&MSUCR9G. printf >] 
ADD ESP, 7 A 

XOR EAX, EAX 8 >46 (NO,NB,E,BE, PE,GE, LE) 
MOU ESP,EBP S 

POP EBP 


c3 RETN 

68 28144000 | PUSH 00401428 

ES 90636086 | CALL 664613EB 

Al ord nou EAH, DWORD PTR Ha C4020601 


ØLFFFFFFFF) 
at FFFFFFFF) 
at FFFFFFFF) 
BLFFFFFFFF) 
7EFOD@G6( FFF) 
OLFFFFFFFF) 


AONDVO 


oo 
c 


" 


OJH t 40 G 
ece 


Pointer to nest SI 
SE handler 


BT ER uus 
(tw Qu t 
uso pe 38u| RETURN to kernel3 


RETURN to ntdll.7 


Figure 1.89: OllyDbg: restoring value of EBP 


Indeed, how it could be different? The compiler may generate some additional code 
to check the index value to be always in the array's bounds (like in higher-level 
programming languages???) but this makes the code slower. 


Writing beyond array bounds 


OK, we read some values from the stack illegally, but what if we could write some- 
thing to it? 


Here is what we have got: 


#include <stdio.h> 


int main() 


{ 


122)aya, Python, etc. 
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int a[20]; 
int i; 


for (i20; i<30; i++) 
alil=i; 


return 0; 


ur 


MSVC 


And what we get: 
Listing 1.234: Non-optimizing MSVC 2008 


TEXT SEGMENT 


.i$ = -84 ; size = 4 
_a$ = -80 ; size = 80 
_main PROC 

push  ebp 

mov ebp, esp 


sub esp, 84 
mov DWORD PTR i$[ebp], 0 
jmp SHORT $LN3@main 


$LN2@main: 
mov eax, DWORD PTR  i$[ebp] 
add eax, 1 
mov DWORD PTR i$[ebp], eax 
$LN3@main: 
cmp DWORD PTR _i$[ebp], 30 ; 0000001eH 
jge SHORT $LN1@main 
mov ecx, DWORD PTR  i$[ebp] 
mov edx, DWORD PTR _i$[ebp] ; that instruction is obviously 
redundant 
mov DWORD PTR _a$[ebp+ecx*4], edx ; ECX could be used as second operand 


here instead 


jmp SHORT $LN2@main 
$LN1@main: 

xor eax, eax 

mov esp, ebp 

pop ebp 

ret 0 
main  ENDP 


The compiled program crashes after running. No wonder. Let's see where exactly 
does it crash. 
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Let's load it into OllyDbg, and trace until all 30 elements are written: 


CPU 


00401000 
00401001 
00401003 
00401006 
00401000 


06401024 
00401028 
60040102A 
Peer te 


0046102F 
60401 E 
98401635 


00403000 
00403010 
00403020 
00403030 
00403040 
00403050 
00403060 


main threa 


5 


EPR 


> 


... +... yn... 


86403076) Ø 


00403080 


60403088 
aa4asaca 
00403000 
00403230E 
00604030F 
Pep 


a 3 
96403140) 8 


00403150 
004 6n 
004 


0403190 ü 


aa4asina 
00403180 
0040310 


96463108) & 


004031E0 
aa4asira 
00403200 


55 

SBEC 

83EC 54 
C745 AC aaa 
EB 09 

8B45 AC 
esco ai 
8945 AC 
837D RC 1E 
7D ac 

SB4D AC 
8B55 RC 
89548D BØ 
EB ES 


ca 

68 14144000 
ES 90030000 
Al 40304000 
C70424 20304 


POP EBP 
RETN 


module 


PUSH_EBP 

MOU EBP,ESP 

SUB ESP,54 

MOV DWORD PTR SS: [LOCAL.211,0 
JMP SHORT 00401018 

MoU ERR, DUORD PTR SS:CLOCAL.21] 


EAX, 
DWORD PTR SS:LLOCRL.211,ERX 
DWORD PTR SS: LLOCRL.211,1E 
SHORT 06040102A 
ECX, DWORD PTR SS:[LOCAL.21] 
EDX, DWORD PTR LOCAL. 211 
DWORD PTR SS: LECX*4*EBP—581, EDX 
MP SHORT 60040100F 
XOR EAX, EAX 
MOU ESP, EBP 


PUSH 00401414 

CALL 96461307 

MOU EAX, DWORD PTR DS: [403040] 

MOV DWORD PTR a cerni li OFFSET 004031 


i " 
y ¡HCHERbO 
anu 


EE 


aaaoaaaniD 
96960610 
90099999 


ODANANDDO 
0000 o 


LastErr 
EFL 00000246 
STO empty 
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aaisrran 
aaisFFa4 
aaisrras 
aaisFFac 
aaisFFia 
Ba1SFFi4 
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0018FF20 
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0018FF28 
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0018F 


aaisFFSS 
aaiSFF3C 
aaisrr4a 
— 


BOTeEraC 
aaisrrsa 
0018FF54 
0018FF58 
@613FFSC 
aaisrrea 
aaiSFFé4 
aa1SFF68 


Ico cm e c ooo 


w. 6840337C 
EIP 6646162F w. 00040102F 


3 32bit 


32bit 
32bit 
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j 32bit 


32bit 


BLFFFFFFFF) 
BLFFFFFFFF) 
BLFFFFFFFF) 
BLFFFFFFFF) 
7EFDDBBBtFFF) 
BLFFFFFFFF) 


00000090 ERROR SUCCESS 
(NO, NB, E, BE, NS, PE, GE, LE) 


m] 
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99006817 
99608018 
00000019 
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000000186 
O0OGOGIC 
99900010 


EXE 


ES 


ETE 


Figure 1.90: OllyDbg: after restoring the value of EBP 
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Trace until the function end: 


CPU - main thread Mie x! 


P 


at FFFFFFFF) 
atFFFFFFFF) 
@( FFFFFFFF) 
OLFFFFFFFF) 
7EFODGG0( FFF) 
atFFFFFFFF) 


y LHCTIIGIRBG Ht 
alu 


+r +++ eH 


z 
D] 


Pointer to next SI 
E handler 


RETURN to kernels: 


RETURN to ntdll.? 


mmmmmmmmmmmmmmnmm 
Tn 
x 


Co JD CO nd ^ 


Pointer to nest SI 
SE handler 


El 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
El 
4 
4 
4 
4 


Figure 1.91: OllyDbg: EIP has been restored, but OllyDbg can’t disassemble at 0x15 


Now please keep your eyes on the registers. 


EIP is 0x15 now. It is not a legal address for code—at least for win32 code! We got 
there somehow against our will. It is also interesting that the EBP register contain 
0x14, ECX and EDX contain Ox1D. 


Let's study stack layout a bit more. 


After the control flow has been passed to main(), the value in the EBP register was 
saved on the stack. Then, 84 bytes were allocated for the array and the i variable. 
That's (20+1)*sizeof(int). ESP now points to the i variable in the local stack 
and after the execution of the next PUSH something, that something is appearing 
nextto i. 


That's the stack layout while the control is in main(): 
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ESP 4 bytes allocated for ; variable 
ESP+4 | 80 bytes allocated for a[20] array 
ESP+84 | saved EBP value 

ESP+88 | return address 


a[19]=something statement writes the last int in the bounds of the array (in bounds 
so far!). 


a[20]=something statement writes something to the place where the value of EBP 
is saved. 


Please take a look at the register state at the moment of the crash. In our case, 20 
has been written in the 20th element. At the function end, the function epilogue 
restores the original EBP value. (20 in decimal is 0x14 in hexadecimal). Then RET 
gets executed, which is effectively equivalent to POP EIP instruction. 


The RET instruction takes the return address from the stack (that is the address in 
CRT, which has called main()), and 21 is stored there (0x15 in hexadecimal). The 
CPU traps at address 0x15, but there is no executable code there, so exception gets 
raised. 


Welcome! It is called a buffer overflow???. 


Replace the int array with a string (char array), create a long string deliberately and 
pass it to the program, to the function, which doesn’t check the length of the string 
and copies it in a short buffer, and you'll able to point the program to an address to 
which it must jump. It's not that simple in reality, but that is how it emerged. Classic 
article about it: [Aleph One, Smashing The Stack For Fun And Profit, (1996)]*?*. 


GCC 


Let's try the same code in GCC 4.4.1. We get: 


public main 


main proc near 
a = dword ptr -54h 
i - dword ptr -4 
push ebp 
mov ebp, esp 
sub esp, 60h ; 96 
mov [ebp+i], 0 
jmp short loc 80483D1 
loc 80483C3: 
mov eax, [ebp+i] 
mov edx, [ebp+i] 
mov [ebp+eax*4+a], edx 
add [ebpt+i], 1 
loc 80483D1: 
cmp [ebp+i], 1Dh 


123 wikipedia 
124Also available as http://yurichev.com/mirrors/phrack/p49-0x0e.txt 
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jte short loc 80483C3 
mov eax, 0 
leave 
retn 
main endp 


Running this in Linux will produce: Segmentation fault. 
If we run this in the GDB debugger, we get this: 


(gdb) r 
Starting program: /home/dennis/RE/1 


Program received signal SIGSEGV, Segmentation fault. 
0x00000016 in ?? () 
(gdb) info registers 


eax 0x0 0 

ecx 0xd2f96388 - 755407992 
edx Ox 1d 29 

ebx 0x26eff4 2551796 

esp Oxbffff4b0 Oxbffff4b0 
ebp 0x15 0x15 

esi 0x0 0 

edi 0x0 0 

eip 0x16 0x16 

eflags 0x10202 [ IF RF ] 

CS 0x73 115 

SS 0x7b 123 

ds 0x7b 123 

es 0x7b 123 

fs 0x0 0 

gs 0x33 51 

(gdb) 


The register values are slightly different than in win32 example, since the stack 
layout is slightly different too. 


1.26.3 Buffer overflow protection methods 


There are several methods to protect against this scourge, regardless of the C/C++ 
programmers’ negligence. MSVC has options like??^: 


/RTCs Stack Frame runtime checking 
/GZ Enable stack checks (/RTCs) 


One of the methods is to write a random value between the local variables in stack 
at function prologue and to check it in function epilogue before the function exits. 
If value is not the same, do not execute the last instruction RET, but stop (or hang). 
The process will halt, but that is much better than a remote attack to your host. 


125compiler-side buffer overflow protection methods: wikipedia.org/wiki/Buffer overflow protection 
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This random value is called a "canary" sometimes, it is related to the miners' ca- 
nary?^?, they were used by miners in the past days in order to detect poisonous 
gases quickly. 


Canaries are very sensitive to mine gases, they become very agitated in case of 
danger, or even die. 


If we compile our very simple array example (1.26.1 on page 331) in MSVC with RTC1 
and RTCs option, 

you can see a call to à RTC CheckStackVarsq8 a function at the end of the function 
that checks if the “canary” is correct. 


Let's see how GCC handles this. Let's take an alloca() (1.9.2 on page 47) example: 


#ifdef | GNUC — 

#include «alloca.h» // GCC 
#else 

#include <malloc.h> // MSVC 
Hendif 

#include <stdio.h> 


void f() 


{ 

char *buf=(char*)alloca (600); 
#ifdef | GNUC _ 

snprintf (buf, 600, "hi! %d, %d, %d\n", 1, 2, 3); // GCC 
#else 

_snprintf (buf, 600, "hi! %d, %d, %d\n", 1, 2, 3); // MSVC 
#endif 


puts (buf); 
}; 


By default, without any additional options, GCC 4.7.3 inserts a “canary” check into 
the code: 


Listing 1.235: GCC 4.7.3 


.LC0: 
.string "hi! %d, %d, %d\n" 

f: 
push ebp 
mov ebp, esp 
push ebx 
sub esp, 676 
lea ebx, [esp+39] 
and ebx, -16 
mov DWORD PTR [esp+20], 3 
mov DWORD PTR [esp+16], 2 
mov DWORD PTR [esp+12], 1 
mov DWORD PTR [esp+8], OFFSET FLAT:.LCO ; "hi! %d, %d, %d\n" 
mov DWORD PTR [esp+4], 600 
mov DWORD PTR [esp], ebx 


126wikipedia.org/wiki/Domestic_canary#Miner.27s_canary 
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mov eax, DWORD PTR gs:20 ; canary 
mov DWORD PTR [ebp-12], eax 
xor eax, eax 
call  snprintf 
mov DWORD PTR [esp], ebx 
call puts 
mov eax, DWORD PTR [ebp-12] 
xor eax, DWORD PTR gs:20 ; check canary 
jne .L5 
mov ebx, DWORD PTR [ebp-4] 
leave 
ret 
¿53 
call . stack chk fail 


The random value is located in gs:20. It gets written on the stack and then at the 
end of the function the value in the stack is compared with the correct “canary” in 
gs:20. If the values are not equal, the stack chk fail function is called and we 
can see in the console something like that (Ubuntu 13.04 x86): 


*** buffer overflow detected ***: ./2 1 terminated 
======= Backtrace: ========= 
/lib/i386-linux-gnu/libc.so.6( fortify fail«0x63)[0xb7699bc3] 
/1lib/i386-linux-gnu/libc.so.6(40x10593a) [0xb769893a] 
/Vib/i386-linux-gnu/libc.so.6(+0x105008)[0xb7698008] 
/lib/i386-linux-gnu/libc.so.6( IO default_xsputn+0x8c)[0xb7606e5c] 
/lib/i386-linux-gnu/libc.so.6( IO vfprintf+0x165) [0xb75d7a45] 
/1ib/i386-linux-gnu/libc.so.6(_ vsprintf_chk+0xc9)[0xb76980d9] 
/lib/i386-linux-gnu/libc.so.6( sprintf_chk+0x2f)[0xb7697fef] 

./2 1[0x8048404] 
/1ib/i386-linux-gnu/libc.so.6(__libc_start_main+0xf5) [0xb75ac935] 


08048000-08049000 r-xp 00000000 08:01 2097586 /home/dennis/2_1 

08049000-0804a000 r--p 00000000 08:01 2097586 /home/dennis/2_1 

0804a000-0804b000 rw-p 00001000 08:01 2097586 /home/dennis/2_1 

094d1000-094f2000 rw-p 00000000 00:00 0 [heap] 

b7560000-b757b000 r-xp 00000000 08:01 1048602 /1ib/i386-linux-gnu/7 
y libgcc s.so.1 

b757b000-b757c000 r--p 0001a000 08:01 1048602 /1ib/i386-linux-gnu/7 
y libgcc s.so.1 

b757c000-b757d000 rw-p 0001b000 08:01 1048602 /1ib/i386-linux-gnu/7 
y libgcc s.so.1 

b7592000-b7593000 rw-p 00000000 00:00 0 

b7593000-b7740000 r-xp 00000000 08:01 1050781 /1ib/i386-linux-gnu/libc 


S -2.17.s0 

b7740000-b7742000 r--p 001ad000 08:01 1050781 /11b/i386-linux-gnu/libc 
S -2.17.s0 

b7742000-b7743000 rw-p 001af000 08:01 1050781 /11b/i386-linux-gnu/libc 
S -2.17.s0 


b7743000-b7746000 rw-p 00000000 00:00 0 
b775a000-b775d000 rw-p 00000000 00:00 0 
b775d000-b775e000 r-xp 00000000 00:00 0 
b775e000-b777e000 r-xp 00000000 08:01 1 


[vdso] 
050794 /11b/i386-linux-gnu/ld 
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G -2.17.s0 

b777e000-b777f000 r--p 0001f000 08:01 1050794 /lib/i386-linux-gnu/ld2 
S -2.17.s0 

b777f000-b7780000 rw-p 00020000 08:01 1050794 /11b/i386-linux-gnu/ld 
S -2.17.s0 

bff35000-bff56000 rw-p 00000000 00:00 0 [stack] 


Aborted (core dumped) 


gs is the so-called segment register. These registers were used widely in MS-DOS 
and DOS-extenders times. Today, its function is different. 


To say it briefly, the gs register in Linux always points to the TLS?? (6.2 on page 944)— 
some information specific to thread is stored there. By the way, in win32 the fs 
register plays the same role, pointing to TIB?28 129, 


More information can be found in the Linux kernel source code (at least in 3.11 ver- 
sion), 
in arch/x86/include/asm/stackprotector.h this variable is described in the comments. 


Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


Let's get back to our simple array example (1.26.1 on page 331), 


again, now we can see how LLVM checks the correctness of the “canary”: 


main 

var 64 = -0x64 
var 60 = -0x60 
var 5C = -0x5C 
var 58 = -0x58 
var_54 = -0x54 
var_50 = -0x50 
var_4C = -0x4C 
var 48 = -0x48 
var 44 = -0x44 
var 40 = -0x40 
var 3C = -0x3C 
var 38 = -0x38 
var 34 = -0x34 
var 30 = -0x30 
var 2C - -0x2C 
var 28 - -0x28 
var 24 = -0x24 
var 20 - -0x20 
var 1C = -0x1C 
var 18 - -0x18 
canary = -0x14 
var 10 - -0x10 


127Thread Local Storage 
128Thread Information Block 
129wikipedia.org/wiki/Win32_Thread_Information_Block 
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{R4-R7,LR} 


R7, 


SP, #0xC 
[SP,#0xC+var_ 10]! 
SP, #0x54 
#a0bjc_methtype ; 


[R8] 
[SP,#0x64+canary ] 
#2 
[SP,#0x64+var 64] 
[SP,#0x64+var_ 60] 
#4 
[SP,#0x64+var_5C] 
#6 
[SP,#0x64+var_ 58] 
#8 
[SP,#0x64+var_ 54] 
#0xA 
[SP,#0x64+var_ 50] 
#0xC 
[SP,#0x64+var_ 4C] 
HOXE 
[SP,#0x64+var_ 48] 
#0x10 
[SP,#0x64+var 44] 
#0x12 
[SP,#0x64+var 40] 
#0x14 
[SP,#0x64+var_ 3C] 
#0x16 
[SP,#0x64+var_ 38] 
#0x18 
[SP,#0x64+var_ 34] 
#0x1A 
[SP,#0x64+var_ 30] 
#0x1C 
[SP,#0x64+var_ 2C] 
#0x1E 
[SP,#0x64+var_ 28] 
#0x20 
[SP,#0x64+var 24] 
#0x22 
[SP,#0x64+var_ 20] 
#0x24 
[SP,#0x64+var_1C] 
#0x26 
[SP,#0x64+var_ 18] 


"objc methtype" 


OxFDA ; "a[%d]=%d\n" 


SP 
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ADDS R6, RO, #4 
ADD R4, PC 
B loc 2F1C 


; second loop begin 


loc 2F14 
ADDS RO, R5, #1 
LDR.W R2, [R6,R5,LSL#2] 
MOV R5, RO 
loc 2F1C 
MOV RO, R4 
MOV R1, R5 
BLX | printf 
CMP R5, 40x13 
BNE loc 2F14 
LDR.W RO, [R8] 
LDR R1, [SP,#0x64+canary] 
CMP RO, R1 
ITTTT EQ ; is canary still correct? 


MOVEQ RO, #0 

ADDEQ SP, SP, 40x54 

LDREQ.W R8, [SP+0x64+var_64] ,#4 
POPEQ {R4-R7,PC} 

BLX . Stack chk fail 


First of all, as we see, LIVM "unrolled" the loop and all values were written into an 
array one-by-one, pre-calculated, as LLVM concluded it can work faster. By the way, 
instructions in ARM mode may help to do this even faster, and finding this could be 
your homework. 


At the function end we see the comparison of the "canaries"—the one in the local 
stack and the correct one, to which R8 points. 


If they are equal to each other, a 4-instruction block is triggered by ITTTT EQ, which 
contains writing 0 in RO, the function epilogue and exit. If the “canaries” are not 
equal, the block being skipped, 

and the jump to stack chk fail function will occur, which, perhaps will halt 
execution. 


1.26.4 One more word about arrays 


Now we understand why it is impossible to write something like this in C/C++ code: 


void f(int size) 
1 


int a[size]; 


po 


That's just because the compiler must know the exact array size to allocate space 
for it in the local stack layout on at the compiling stage. 
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If you need an array of arbitrary size, allocate it by using malloc(), then access the 
allocated memory block as an array of variables of the type you need. 


Or use the C99 standard feature [ISO/IEC 9899:TC3 (C C99 standard), (2007)6.7.5/2], 
and it works like a/loca() (1.9.2 on page 47) internally. 


It'S also possible to use garbage collecting libraries for C. 


And there are also libraries supporting smart pointers for C++. 


1.26.5 Array of pointers to strings 
Here is an example for an array of pointers. 


Listing 1.236: Get month name 


#include <stdio.h> 


const char* month1[]= 


{ 
"January", "February", "March", "April", 
"May", "June", "July", "August", 
"September", "October", "November", "December" 
}; 


// in 0..11 range 
const char* get monthl (int month) 


1 
return month1[month]; 


Fi 


x64 


Listing 1.237: Optimizing MSVC 2013 x64 


_DATA SEGMENT 


monthl DQ FLAT: $SG3122 
DQ FLAT: $SG3123 
DQ FLAT: $5G3124 
DQ FLAT: $SG3125 
DQ FLAT: $5G3126 
DQ FLAT: $5G3127 
DQ FLAT: $5G3128 
DQ FLAT: $5G3129 
DQ FLAT: $5G3130 
DQ FLAT:$5G3131 
DQ FLAT: $5G3132 
DQ FLAT: $5G3133 
$5G3122 DB 'January', 00H 
$SG3123 DB 'February', 00H 
$5G3124 DB 'March', 00H 
$5G3125 DB 'April', 00H 
$5G3126 DB 'May', 00H 
$5G3127 DB 'June', 00H 
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$5G3128 DB 'July', 00H 
$5G3129 DB 'August', 00H 
$5G3130 DB 'September', 00H 
$5G3156 DB '%s', O0aH, OOH 
$5G3131 DB 'October', 00H 
$5G3132 DB 'November', 00H 
$5G3133 DB 'December', 00H 
DATA ENDS 

month$ = 8 


get monthl PROC 
movsxd rax, ecx 


lea rcx, OFFSET FLAT:month1 
mov rax, QWORD PTR [rcx+rax*8] 
ret 0 


get monthl ENDP 


The code is very simple: 


* The first MOVSXD instruction copies a 32-bit value from ECX (where month argu- 
ment is passed) to RAX with sign-extension (because the month argument is of 
type int). 


The reason for the sign extension is that this 32-bit value is to be used in calcu- 
lations with other 64-bit values. 


Hence, it has to be promoted to 64-bit?*°. 


Then the address of the pointer table is loaded into RCX. 


Finally, the input value (month) is multiplied by 8 and added to the address. 
Indeed: we are in a 64-bit environment and all address (or pointers) require 
exactly 64 bits (or 8 bytes) for storage. Hence, each table element is 8 bytes 
wide. And that's why to pick a specific element, month+8 bytes has to be skipped 
from the start. That's what MOV does. In addition, this instruction also loads the 
element at this address. For 1, an element would be a pointer to a string that 
contains "February", etc. 


Optimizing GCC 4.9 can do the job even better !3!: 
Listing 1.238: Optimizing GCC 4.9 x64 


movsx rdi, edi 
mov rax, QWORD PTR month1[0+rdi*8] 
ret 


1301t is somewhat weird, but negative array index could be passed here as month (negative array indices 
will have been explained later: 3.22 on page 752). And if this happens, the negative input value of int 
type is sign-extended correctly and the corresponding element before table is picked. It is not going to 
work correctly without sign-extension. 

131“0+” was left in the listing because GCC assembler output is not tidy enough to eliminate it. It's 
displacement, and it’s zero here. 
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32-bit MSVC 


Let's also compile it in the 32-bit MSVC compiler: 
Listing 1.239: Optimizing MSVC 2013 x86 


_month$ = 8 

get monthl PROC 
mov eax, DWORD PTR month$[esp-4] 
mov eax, DWORD PTR _monthl[eax*4] 
ret 0 


get monthl ENDP 


The input value does not need to be extended to 64-bit value, so it is used as is. 


And it's multiplied by 4, because the table elements are 32-bit (or 4 bytes) wide. 


32-bit ARM 
ARM in ARM mode 


Listing 1.240: Optimizing Keil 6/2013 (ARM mode) 


get monthl PROC 


LDR r1,|L0.100]| 

LDR ro,[r1,ro,LsL #2] 

BX lr 

ENDP 
|LO.100| 

DCD || .data| | 

DCB "January" ,0 

DCB "February" ,0 

DCB "March" ,0 

DCB "April",0 

DCB "May",0 

DCB "June",0 

DCB "July",0 

DCB "August" ,0 

DCB "September",0 

DCB "October",0 

DCB "November" ,0 

DCB "December",0 

AREA ||.data||, DATA, ALIGN=2 
month1 

DCD conststring|| 

DCD conststring| |+0x8 

DCD conststring| |+0x11 


DCD conststring||+0x1d 


| | . 
| | . 
| | . 
DCD | | .conststring | |+0x17 
| | . 
DCD | | .conststring | |+0x21 
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DCD .conststring| |+0x26 
DCD .conststring||+0x2b 
DCD .conststring| |+0x32 


DCD .conststring| |+0x44 


| | 
| | 
| | 
DCD || .conststring | |+0x3c 
| | 
DCD || .conststring | |+0x4d 


The address of the table is loaded in R1. 
All the rest is done using just one LDR instruction. 


Then input value month is shifted left by 2 (which is the same as multiplying by 4), 
then added to R1 (where the address of the table is) and then a table element is 
loaded from this address. 


The 32-bit table element is loaded into RO from the table. 


ARM in Thumb mode 


The code is mostly the same, but less dense, because the LSL suffix cannot be spec- 
ified in the LDR instruction here: 


get monthl PROC 


LSLS r0,r0,#2 
LDR r1,|L0.64] 
LDR ro,[r1,r0] 
BX lr 

ENDP 


ARM64 
Listing 1.241: Optimizing GCC 4.9 ARM64 
get monthl: 
adrp X1, .LANCHORO 
add X1, x1, :1012:.LANCHORO 
ldr x0, [x1,w0,sxtw 3] 
ret 
.LANCHORO = . + 0 
.type | monthl, %object 
.Size month1, 96 
month1: 
.xword .LC2 
.xword .LC3 
.xword .LC4 
.xword .LC5 
.xword .LC6 
.xword .LC7 
.xword .LC8 
.xword .LC9 
.xword .LC10 
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.Xword  .LC11 

.xword .LC12 

.xword  .LC13 
.LC2: 

.string "January" 
.LC3: 

.string "February" 
.LC4: 

.string "March" 
.LC5: 

.string "April" 
.LC6: 

.string "May" 
.LC7: 

.string "June" 
.LC8: 

.string "July" 
.LC9: 

.string "August" 
.LC10: 

.string "September" 
.LC11: 

.string "October" 
.LC12: 

.string "November" 
.LC13: 


.string "December" 


The address of the table is loaded in X1 using ADRP/ADD pair. 


Then corresponding element is picked using just one LDR, which takes WO (the reg- 
ister where input argument month is), shifts it 3 bits to the left (which is the same as 
multiplying by 8), sign-extends it (this is what "sxtw" suffix implies) and adds to XO. 
Then the 64-bit value is loaded from the table into XO. 


MIPS 


Listing 1.242: Optimizing GCC 4.4.5 (IDA) 


get monthl: 

; load address of table into $v0: 
la $v0, monthl 

take input value and multiply it by 4: 
sll $a0, 2 

sum up address of table and multiplied value: 
addu $a0, $v0 

load table element at this address into $v0: 


lw $v0, 0($a0) 
; return 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


.data £ .data.rel.local 
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.globl month1 

month1: .word aJanuary # "January" 
.word aFebruary # "February" 
.word aMarch # "March" 
.word aApril # "April" 
.word aMay # "May" 
.word aJune # "June" 
.word aJuly # "July" 
.word aAugust # "August" 
.word aSeptember # "September" 
.word a0ctober # "October" 
.word aNovember # "November" 
.word aDecember # "December" 
.data + .rodata.str1.4 

aJanuary: .ascii "January"<0> 

aFebruary: „ascii "February"<0> 

aMarch: .ascii "March"<0> 

aApril: .ascii "April"<0> 

aMay: .ascii "May"<0> 

aJune: .ascii "June"<0> 

aJuly: .ascii "July"<0> 

aAugust: .ascii "August"<0> 

aSeptember: .ascii "September"<0> 

a0ctober: .ascii "October"<Q> 

aNovember : .ascii "November"<0> 

aDecember: .ascii "December"<0> 


Array overflow 


Our function accepts values in the range of 0..11, but what if 12 is passed? There is 
no element in table at this place. 


So the function will load some value which happens to be there, and return it. 


Soon after, some other function can try to get a text string from this address and 


may crash. 


Let's compile the example in MSVC for win64 and open it in IDA to see what the 


linker has placed after the table: 


Listing 1.243: Executable file in IDA 


.text:0000000140001003 


off 140011000 dq offset aJanuary 1 ; DATA XREF: 
; "January" 

dq offset aFebruary 1 ; "February" 
dq offset aMarch 1 ; "March" 
dq offset aApril 1 ; "April" 
dq offset aMay 1 ; "May" 
dq offset aJune 1 ; "June" 
dq offset aJuly 1 ; "July" 
dq offset aAugust 1 ; "August" 
dq offset aSeptember 1 ; "September" 
dq offset aOctober 1 ; "October" 
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dq offset aNovember 1 ; "November" 
dq offset aDecember 1 "December" 
aJanuary 1 db 'January',0 DATA XREF: sub 14000102044 


.data:off 140011000 


aFebruary 1 db 'February',0 DATA XREF: .data:0000000140011008 
align 4 

aMarch 1 db 'March',0 ; DATA XREF: .data:0000000140011010 
align 4 

aApril 1 db 'April',0 ; DATA XREF: .data:0000000140011018 


Month names are came right after. 


Our program is tiny, so there isn't much data to pack in the data segment, so it just 
the month names. But it has to be noted that there might be really anything that 
linker has decided to put by chance. 


So what if 12 is passed to the function? The 13th element will be returned. 


Let's see how the CPU treats the bytes there as a 64-bit value: 


Listing 1.244: Executable file in IDA 


off 140011000 dq offset qword 140011060 
; DATA XREF: .text:0000000140001003 


dq offset aFebruary 1 "February" 
dq offset aMarch 1 "March" 

dq offset aApril 1 "April" 

dq offset aMay 1 "May" 

dq offset aJune 1 "June" 

dq offset aJuly 1 "July" 


dq offset aSeptember 1 "September" 
dq offset aOctober 1 "October" 

dq offset aNovember 1 "November" 
dq offset aDecember 1 "December" 


qword 140011060 dq 797261756E614Ah DATA XREF: sub 14000102044 


dq offset aAugust 1 ; "August" 
; .data:off 140011000 


aFebruary 1 db 'February',0 ; DATA XREF: .data:0000000140011008 
align 4 
aMarch 1 db 'March',0 ; DATA XREF: .data:0000000140011010 


And this is 0x797261756E614A. 


Soon after, some other function (presumably, one that processes strings) may try to 
read bytes at this address, expecting a C-string there. 


Most likely it is about to crash, because this value doesn't look like a valid address. 


Array overflow protection 
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If something can go wrong, it will 


Murphy's Law 


It's a bit naive to expect that every programmer who use your function or library will 
never pass an argument larger than 11. 


There exists the philosophy that says "fail early and fail loudly" or "fail-fast", which 
teaches to report problems as early as possible and halt. 


One such method in C/C++ is assertions. 


We can modify our program to fail if an incorrect value is passed: 


Listing 1.245: assert() added 


const char* get monthl checked (int month) 
1 
assert (month«12); 
return month1[month]; 
ur 


The assertion macro checks for valid values at every function start and fails if the 
expression is false. 


Listing 1.246: Optimizing MSVC 2013 x64 


$5G3143 DB 'm', OOH, 'o', OOH, 'n', OOH, 't', OOH, 'h', OOH, '.', 00H 
DB 'c', 00H, 00H, 00H 
$5G3144 DB 'm', OOH, 'o', OOH, 'n', OOH, 't', OOH, 'h', OOH, '«', 00H 
DB '1', 00H, '2', OOH, OOH, OOH 
month$ = 48 
get monthl checked PROC 
$LN5: 
push rbx 
sub rsp, 32 
movsxd rbx, ecx 
cmp ebx, 12 
jl SHORT $LN3Gget monthl 
lea rdx, OFFSET FLAT:$5G3143 
lea rcx, OFFSET FLAT:$SG3144 
mov rad, 29 
call _wassert 
$LN3Gget monthl: 
lea rcx, OFFSET FLAT:monthl 
mov rax, QWORD PTR [rcx+rbx*8] 
add rsp, 32 
pop rbx 
ret 0 


get monthl checked ENDP 


In fact, assert() is not a function, but macro. It checks for a condition, then passes 
also the line number and file name to another function which reports this information 
to the user. 
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Here we see that both file name and condition are encoded in UTF-16. The line 
number is also passed (it's 29). 


This mechanism is probably the same in all compilers. Here is what GCC does: 


Listing 1.247: Optimizing GCC 4.9 x64 


.LC1: 

.string "month.c" 
.LC2: 

.string "month<12" 


get monthl checked: 


cmp edi, 11 
jg .L6 
movsx rdi, edi 
mov rax, QWORD PTR month1[0+rdi*8] 
ret 
.L6: 
push rax 
mov ecx, OFFSET FLAT: PRETTY FUNCTION .2423 
mov edx, 29 
mov esi, OFFSET FLAT:.LC1 
mov edi, OFFSET FLAT:.LC2 
call . assert fail 


_ PRETTY FUNCTION .2423: 
.string "get monthl checked" 


So the macro in GCC also passes the function name for convenience. 
Nothing is really free, and this is true for the sanitizing checks as well. 


They make your program slower, especially if the assert() macros used in small time- 
critical functions. 


So MSVC, for example, leaves the checks in debug builds, but in release builds they 
all disappear. 


Microsoft Windows NT kernels come in "checked" and "free" builds 122. 


The first has validation checks (hence, "checked"), the second one doesn't (hence, 
"free" of checks). 


Of course, "checked" kernel works slower because of all these checks, so it is usually 
used only in debug sessions. 


Accessing specific character 


An array of pointers to strings can be accessed like this: 


#include <stdio.h> 


const char* month[]= 


132msdn.microsoft.com/en-us/library/windows/hardware/ff543450(v=vs.85).aspx 
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{ 
"January", "February", "March", "April", 
"May", "June", "July", "August", 
"September", "October", "November", "December" 
}; 
int main() 
{ 
// 4th month, 5th character: 
printf ("%c\n", month[3][4]); 
}; 


...since month[3] expression has a const char* type. And then, 5th character is taken 
from that expression by adding 4 bytes to its address. 


By the way, arguments list passed to main() function has the same data type: 


#include <stdio.h> 


int main(int argc, char *argv[]) 


{ 
Fi 


printf ("3rd argument, 2nd character: %c\n", argv[3][1]); 


It's very important to understand, that, despite similar syntax, this is different from 
two-dimensional arrays, which we will consider later. 


Another important thing to notice: strings to be addressed must be encoded in a 
system, where each character occupies single byte, like ASCII}? and extended ASCII. 
UTF-8 wouldn't work here. 


1.26.6 Multidimensional arrays 


Internally, a multidimensional array is essentially the same thing as a linear array. 


Since the computer memory is linear, it is an one-dimensional array. For conve- 
nience, this multi-dimensional array can be easily represented as one-dimensional. 


For example, this is how the elements of the 3x4 array are placed in one-dimensional 
array of 12 cells: 


133American Standard Code for Information Interchange 
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Offset in memory | array element 
[0][0] 


H| E O| œ Y OY UT) A UU NI ej © 
m 
=| | A A mE 


0 [21[2] 
1 


Table 1.3: Two-dimensional array represented in memory as one-dimensional 


Here is how each cell of 3*4 array are placed in memory: 


0/1 2 3 
415|6 |7 
8 9/10 11 


Table 1.4: Memory addresses of each cell of two-dimensional array 


So, in order to calculate the address of the element we need, we first multiply the 
first index by 4 (array width) and then add the second index. That's called row-major 
order, and this method of array and matrix representation is used in at least C/C++ 
and Python. The term row-major order in plain English language means: “first, write 
the elements of the first row, then the second row ...and finally the elements of the 
last row”. 


Another method for representation is called column-major order (the array indices 
are used in reverse order) and it is used at least in Fortran, MATLAB and R. column- 
major order term in plain English language means: “first, write the elements of the 
first column, then the second column ...and finally the elements of the last column”. 


Which method is better? 


In general, in terms of performance and cache memory, the best scheme for data 
organization is the one, in which the elements are accessed sequentially. 


So if your function accesses data per row, row-major order is better, and vice versa. 


Two-dimensional array example 


We are going to work with an array of type char, which implies that each element 
requires only one byte in memory. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


365 


Row filling example 


Let's fill the second row with these values 0..3: 


Listing 1.248: Row filling example 


#include <stdio.h> 
char a[3][4]; 


int main() 


{ 


int x, y; 


// clear array 
for (x=0; x«3; X++) 
for (y=0; y<4; y++) 
alx1[y1=0; 


// fill second row by 0..3: 
for (y=0; y«4; y++) 
a[1][yley; 
$; 


All three rows are marked with red. We see that second row now has values 0, 1, 2 
and 3: 


odorato! 


S Cur Co Co cn 


al 
B 
[5] 
A 


Figure 1.92: OllyDbg: array is filled 


Column filling example 


Let’s fill the third column with values: 0..2: 


Listing 1.249: Column filling example 


#include <stdio.h> 
char a[3][4]; 


int main() 


{ 


int x, y; 


// clear array 
for (x=0; x<3; x++) 
for (y=0; y<4; y++) 
alx1[y1=0; 
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// fill third column by 0..2: 
for (x20; x«3; x++) 
a[x][2]=x; 
ur 


The three rows are also marked in red here. 


We see that in each row, at third position these values are written: 0, 1 and 2. 


p 

DIA Bü Ba 60 golog 60 Gl poleo OG 62 oajaz oo OB GO 
H oa 60 WB IE Hh nn oG Ba Ba Bo 
a 60 BB GB BB BB 60 00 GB gð oo ğü oo BB 60 GB 
& 60 BB BB BB pa 60 66 BB 60 HA BO Gö BB HA BH 


Figure 1.93: OllyDbg: array is filled 


Access two-dimensional array as one-dimensional 


We can be easily assured that it's possible to access a two-dimensional array as 
one-dimensional array in at least two ways: 


#include <stdio.h> 
char a[3][4]; 


char get by coordinatesl (char array[3][4], int a, int b) 


1 
return array[a] [b]; 
}; 
char get by coordinates2 (char *array, int a, int b) 
{ 
// treat input array as one-dimensional 
// 4 is array width here 
return array[a*4+b]; 
}; 
char get by coordinates3 (char *array, int a, int b) 
1 
// treat input array as pointer, 
// calculate address, get value at it 
// 4 is array width here 
return *(array+a*4+b); 
}; 
int main() 
a[2][3]=123; 
printf ("%d\n", get by coordinatesl(a, 2, 3)); 
printf ("%d\n", get by coordinates2(a, 2, 3)); 
printf ("%d\n", get by coordinates3(a, 2, 3)); 
}; 
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Compile*”* and run it: it shows correct values. 


What MSVC 2013 did is fascinating, all three routines are just the same! 
Listing 1.250: Optimizing MSVC 2013 x64 


array$ = 8 
a$ = 16 
b$ = 24 


get by coordinates3 PROC 
; RCX=address of array 


; RDX=a 
; R8=b 

movsxd rax, r8d 
; EAX=b 

movsxd r9, edx 
; R9=a 

add rax, rcx 


RAX=b+address of array 
movzx eax, BYTE PTR [rax+r9*4] 
AL-load byte at address RAX+R9*4=b+address of array+a*4=address of 
array+a*4+b 
ret 0 
get by coordinates3 ENDP 


array$ = 8 
a$ - 16 
b$ = 24 


get by coordinates2 PROC 
movsxd rax, r8d 
movsxd r9, edx 


add rax, rcx 
movzx eax, BYTE PTR [rax+r9*4] 
ret 0 


get by coordinates2 ENDP 


array$ = 8 
a$ - 16 
b$ = 24 


get by coordinatesl PROC 
movsxd rax, r8d 
movsxd r9, edx 


add rax, rcx 
movzx eax, BYTE PTR [rax+r9*4] 
ret 0 


get by coordinatesl ENDP 


GCC also generates equivalent routines, but slightly different: 


Listing 1.251: Optimizing GCC 4.9 x64 


; RDI=address of array 
; RSI-a 


134This program is to be compiled as a C program, not C++, save it to a file with .c extension to compile 
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; RDX=b 


get by coordinatesl: 
; Sign-extend input 32-bit int values "a" and "b" to 64-bit ones 
movsx rsi, esi 
movsx rdx, edx 
lea rax, [rdi+rsi*4] 
; RAX=RDI+RSI*4=address of array+a*4 
movzx eax, BYTE PTR [rax+rdx] 
; AL=load byte at address RAX+RDX=address of array+a*4+b 
ret 


get by coordinates2: 


lea eax, [rdx+rsi*4] 
; RAX=RDX+RSI*4=b+a*4 
cdqe 


movzx eax, BYTE PTR [rdi+rax] 
; AL=load byte at address RDI+RAX=address of array+b+a*4 
ret 


get by coordinates3: 
sal esi, 2 

; ESI=a<<2=a*4 

; sign-extend input 32-bit int values "a*4" and "b" to 64-bit ones 
movsx rdx, edx 
movsx rsi, esi 
add rdi, rsi 

; RDI=RDI+RSI=address of array+a*4 
movzx eax, BYTE PTR [rdi+rdx] 

; AL=load byte at address RDI+RDX=address of array+a*4+b 
ret 


Three-dimensional array example 


It’s the same for multidimensional arrays. 


Now we are going to work with an array of type int: each element requires 4 bytes 
in memory. 


Let’s see: 


Listing 1.252: simple example 


#include <stdio.h> 
int a[10][20] [30]; 


void insert(int x, int y, int z, int value) 


{ 
F 


a[x][y][z]=value; 
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x86 


We get (MSVC 2010): 
Listing 1.253: MSVC 2010 


DATA SEGMENT 

COMM . a:DWORD : 01770H 
DATA ENDS 

PUBLIC A. insert 

_ TEXT SEGMENT 


_x$ = 8 ; size = 4 
_y$ = 12 ; size = 4 
_z$ = 16 ; size = 4 
_value$ = 20 ; size = 4 
_insert PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR x$[ebp] 
imul eax, 2400 ; eax=600*4*x 
mov ecx, DWORD PTR y$[ebp] 
imul ecx, 120 ; ecx=30*4*y 
lea edx, DWORD PTR _a[eax+ecx] ; edx=a + 600*4*x + 30*4*y 


mov eax, DWORD PTR _z$[ebp] 
mov ecx, DWORD PTR _value$[ebp] 


mov DWORD PTR [edx+eax*4], ecx ; *(edx+z*4)=value 
pop ebp 
ret 0 

_insert ENDP 

_TEXT ENDS 


Nothing special. For index calculation, three input arguments are used in the formula 
address = 600 - 4- x + 30-4- y + 4z, to represent the array as multidimensional. Do not 
forget that the int type is 32-bit (4 bytes), so all coefficients must be multiplied by 
4. 


Listing 1.254: GCC 4.4.1 


public insert 
insert proc near 


dword ptr 8 
dword ptr Ch 
ptr 10h 


N 
uou wg al 
[93 
= 
o 
3 
¡ol 


value dword ptr 14h 
push ebp 
mov ebp, esp 
push ebx 
mov ebx, [ebp+x] 
mov eax, [ebpty] 
mov ecx, [ebp+z] 
lea edx, [eax+eax] ; edx=y*2 
mov eax, edx ; eax=y*2 
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shl eax, 4 ; eax=(y*2)<<4 = y*2*16 = y*32 
sub eax, edx ; @ax=y*32 - y*2zy*30 

imul edx, ebx, 600 ; edx=x*600 

add eax, edx ; eax=eaxtedx=y*30 + x*600 

lea edx, [eax+ecx] ; edxzy*30 + x*600 + z 

mov eax, [ebp+value] 

mov dword ptr ds:a[edx*4], eax ; *(a+edx*4)=value 
pop ebx 

pop ebp 

retn 


insert endp 


The GCC compiler does it differently. 


For one of the operations in the calculation (30y), GCC produces code without multipli- 
cation instructions. This is how it done: (y+y) << 4-(y+y) = (2y) « 4-2y = 2-16-y-2y = 
32y - 2y = 30y. Thus, for the 30y calculation, only one addition operation, one bitwise 
shift operation and one subtraction operation are used. This works faster. 


ARM + Non-optimizing Xcode 4.6.3 (LLVM) (Thumb mode) 


Listing 1.255: Non-optimizing Xcode 4.6.3 (LLVM) (Thumb mode) 


_insert 

value = -0x10 
Z = -0xC 
y = -8 
X = -4 


; allocate place in local stack for 4 values of int type 


SUB SP, SP, #0x10 

MOV R9, OxFC2 ; a 

ADD R9, PC 

LDR.W — R9, [R9] ; get pointer to array 
STR RO, [SP,#0x10+x] 

STR R1, [SP,#0x10+y] 

STR R2, [SP,#0x10+z] 

STR R3, [SP,#0x10+vaLlue] 
LDR RO, [SP,#0x10+value] 
LDR R1, [SP,#0x10+z] 

LDR R2, [SP,#0x10+y] 

LDR R3, [SP,#0x10+x] 

MOV R12, 2400 

MUL.W R3, R3, R12 

ADD R3, R9 

MOV R9, 120 

MUL.W R2, R2, R9 

ADD R2, R3 

LSLS R1, R1, #2 ; R1=R1<<2 
ADD R1, R2 

STR RO, [R1] ; Rl - address of array element 
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; deallocate chunk in local stack, allocated for 4 values of int type 
ADD SP, SP, #0x10 
BX LR 


Non-optimizing LLVM saves all variables in local stack, which is redundant. 


The address of the array element is calculated by the formula we already saw. 


ARM + Optimizing Xcode 4.6.3 (LLVM) (Thumb mode) 


Listing 1.256: Optimizing Xcode 4.6.3 (LLVM) (Thumb mode) 


insert 

MOVW R9, #0x10FC 

MOV.W R12, #2400 

MOVT.W R9, #0 

RSB.W R1, R1, R1,LSL#4 ; R1 - y. Rl=y<<4 - y = y*16 - y = y*15 
ADD R9, PC 


LDR.W R9, [R9] ; R9 = pointer to an array 

MLA.W RO, RO, R12, R9 ; RO - x, R12 - 2400, R9 - pointer to a. RO=x*2400 
+ ptr to a 

ADD.W RO, RO, RI,LSLZ3 ; RO = RO«R1««3 = RO+R1*8 = x*2400 + ptr to a + 
y*15*8 = 


; ptr to a + y*30*4 + x*600*4 

STR.W R3, [RO,R2,LSLZ2] ; R2 - z, R3 - value. address=R0+z*4 = 
; ptr to a + y*30*4 + x*600*4 + z*4 

BX LR 


The tricks for replacing multiplication by shift, addition and subtraction which we 
already saw are also present here. 


Here we also see a new instruction for us: RSB (Reverse Subtract). 


It works just as SUB, but it swaps its operands with each other before execution. 
Why? SUB and RSB are instructions, to the second operand of which shift coefficient 
may be applied: (LSL#4). 


But this coefficient can be applied only to second operand. 


That’s fine for commutative operations like addition or multiplication (operands may 
be swapped there without changing the result). 


But subtraction is a non-commutative operation, so RSB exist for these cases. 
MIPS 


My example is tiny, so the GCC compiler decided to put the a array into the 64KiB 
area addressable by the Global Pointer. 


Listing 1.257: Optimizing GCC 4.4.5 (IDA) 


insert: 
; $a0=x 
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; $al=y 
; $a2-2z 
; $a3-value 
sll $v0, $a0, 5 
; $vO = $a0««5 = x*32 
sll $a0, 3 


; $a0 = $a0<<3 = x*8 
addu $a0, $v0 
; $a0 = $a0+$v0 = x*8+x*32 = x*40 


sll $v1, $al, 5 
; $v1 = $al<<5 = y*32 

sll $v0, $a0, 4 
; $vO = $a0««4 = x*40*16 = x*640 

sll $al, 1 


; $al = $al««1 = y*2 
subu $al, $v1, $al 
; $al = $vl-$al = y*32-y*2 = y*30 
subu $a0, $v0, $a0 
; $a0 = $v0-$a0 = x*640-x*40 = x*600 
la $gp, _ gnu local gp 
addu $a0, $al, $a0 
; $a0 = $al+$a0 = y*30+x*600 
addu $a0, $a2 
; $a0 = $a0+$a2 = y*30+x*600+z 
load address of table: 


lw $v0, (a € OxFFFF) ($gp) 
; multiply index by 4 to seek array element: 
sll $a0, 2 


; sum up multiplied index and table address: 
addu $a0, $v0, $a0 

store value into table and return: 
jr $ra 
SW $a3, 0($a0) 


.comm a:0x1770 


Getting dimensions of multidimensional array 


Any string processing function, if an array of characters passed to it, can't deduce a 
size of the input array. Likewise, if a function processes 2D array, only one dimension 
can be deduced. 


For example: 


int get element(int array[10][20], int x, int y) 


1 
return array[x] [y]; 
ur 
int main() 
1 


int array[10][20]; 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


373 


get element(array, 4, 5); 
y; 


. if compiled (by any compiler) and then decompiled by Hex-Rays: 


int get element(int *array, int x, int y) 


{ 
} 


return array[20 * x + y]; 


There is no way to find a size of the first dimension. If z value passed is too big, 
buffer overflow would occur, an element from some random place of memory would 
be read. 


And 3D array: 


int get element(int array[10][20][30], int x, int y, int z) 
1 


return array[x][yl[z]; 


}; 
int main() 
: int array[10][20] [30] ; 
get element(array, 4, 5, 6); 
$; 
Hex-Rays: 


int get element(int *array, int x, int y, int z) 


{ 
I 


return array[600 * x + z + 30 * y]; 


Again, sizes of only two of 3 dimensions can be deduced. 


More examples 


The computer screen is represented as a 2D array, but the video-buffer is a linear 
1D array. We talk about it here: 8.15.2 on page 1155. 


Another example in this book is Minesweeper game: it's field is also two-dimensional 
array: 8.4 on page 1021. 


1.26.7 Pack of strings as a two-dimensional array 


Let's revisit the function that returns the name of a month: listing.1.236. 


As you see, at least one memory load operation is needed to prepare a pointer to 
the string that's the month's name. 


Is it possible to get rid of this memory load operation? 
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In fact yes, if you represent the list of strings as a two-dimensional array: 


#include <stdio.h> 
#include <assert.h> 


const char month2[12][10]= 
{ 


{ 'J','a','n','u','‘a','r','y', 0, 0, 0], 
1 'F''e','b','r','u','a','r','y', 0, 0 }, 
{ 'M','a','r','c','h', 0, 0, 0, 0, 0 }, 
{ UN VD po Pe yas ys Lg 0, 0, 0, 0, 0 }, 
{ 'M','a','y', 0, 0, 0, 0, 0, 0, 0 }, 
{ 'J','u','n','e', 0, 0, 0, 0, 0, 0 }, 
{ 'J','u','l';'y', 0, 0, 0, 0, 0, 0 Ys 
1 "At 7u WO oW s S p ty 0, 0, 0, 0 }, 
{ 'S','e','p','t','e','m','b','e','r', 0 }, 
{ 'Q','c','t','o','b','e','r', 0, 0, 0 }, 
{ 'N','o','v','e','m','b','e','r', 0, 0 }, 
{ 'D','e','c','e','m','b','e','r', 0, 0 } 


// in 0..11 range 
const char* get month2 (int month) 


1 


return &month2[month] [0] ; 


Here is what we've get: 
Listing 1.258: Optimizing MSVC 2013 x64 


month2 DB 04aH 
DB 061H 
DB 06eH 
DB 075H 
DB 061H 
DB 072H 
DB 079H 
DB 00H 
DB 00H 
DB 00H 


get_month2 PROC 
; sign-extend input argument and promote to 64-bit value 
movsxd rax, ecx 
lea rcx, QWORD PTR [rax+rax*4] 
; RCX=month+month*4=month*5 
lea rax, OFFSET FLAT:month2 
; RAXepointer to table 
lea rax, QWORD PTR [rax+rcx*2] 
; RAX=pointer to table + RCX*2=pointer to table + month*5*2=pointer to table 


+ month*10 
ret 0 


get_month2 ENDP 
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There are no memory accesses at all. 


All this function does is to calculate a point at which the first character of the name 
of the month is: pointer to the table + month » 10. 


There are also two LEA instructions, which effectively work as several MUL and MOV 
instructions. 


The width of the array is 10 bytes. 


Indeed, the longest string here—“September”—is 9 bytes, and plus the terminating 
zero is 10 bytes. 


The rest of the month names are padded by zero bytes, so they all occupy the same 
space (10 bytes). 


Thus, our function works even faster, because all string start at an address which 
can be calculated easily. 


Optimizing GCC 4.9 can do it even shorter: 
Listing 1.259: Optimizing GCC 4.9 x64 


movsx rdi, edi 


lea rax, [rdi+rdi*4] 
lea rax, month2[rax+rax] 
ret 


LEA is also used here for multiplication by 10. 


Non-optimizing compilers do multiplication differently. 


Listing 1.260: Non-optimizing GCC 4.9 x64 


get month2: 
push rbp 
mov rbp, rsp 
mov DWORD PTR [rbp-4], edi 
mov eax, DWORD PTR [rbp-4] 


movsx rdx, eax 
; RDX = sign-extended input value 


mov rax, rdx 
; RAX = month 
sal rax, 2 
; RAX = month<<2 = month*4 
add rax, rdx 
; RAX = RAX+RDX = month*4+month = month*5 
add rax, rax 
; RAX = RAX*2 = month*5*2 = month*10 
add rax, OFFSET FLAT:month2 
; RAX = month*10 + pointer to the table 
pop rbp 
ret 


Non-optimizing MSVC just uses IMUL instruction: 
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Listing 1.261: Non-optimizing MSVC 2013 x64 


month$ - 8 
get month2 PROC 
mov DWORD PTR [rsp+8], ecx 
movsxd rax, DWORD PTR month$[rsp] 
; RAX = sign-extended input value into 64-bit one 


imul rax, rax, 10 
; RAX = RAX*10 
lea rcx, OFFSET FLAT: month2 
; RCX = pointer to the table 
add rcx, rax 
; RCX = RCX+RAX = pointer to the table+month*10 
mov rax, rcx 
; RAX = pointer to the table+month*10 
mov ecx, 1 
; RCX = 1 
imul rcx, rcx, 0 
; RCX = 1*0 = 0 
add rax, rcx 
; RAX = pointer to the table+month*10 + 0 = pointer to the table+month*10 
ret 0 


get_month2 ENDP 


But one thing is weird here: why add multiplication by zero and adding zero to the 
final result? 


This looks like a compiler code generator quirk, which wasn’t caught by the com- 
piler’s tests (the resulting code works correctly, after all). We intentionally consider 
such pieces of code so the reader would understand, that sometimes one shouldn’t 
puzzle over such compiler artifacts. 

32-bit ARM 

Optimizing Keil for Thumb mode uses the multiplication instruction MULS: 


Listing 1.262: Optimizing Keil 6/2013 (Thumb mode) 


; RO = month 
MOVS r1,#0xa 
; R1= 10 
MULS ro,r1,ro 
; RO = R1*RO = 10*month 
LDR r1,|L0.68] 
; R1 = pointer to the table 
ADDS r0,r0,r1 
; RO = RO+R1 = 10*month + pointer to the table 
BX lr 


Optimizing Keil for ARM mode uses add and shift operations: 


Listing 1.263: Optimizing Keil 6/2013 (ARM mode) 


; RO = month 
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LDR r1,|L0.104]| 
; R1 = pointer to the table 
ADD r0,r0,r0,LSL #2 
; RO = RO+RO<<2 = RO+RO*4 = month*5 
ADD r0,r1,r0,LSL #1 
; RO = R1+RO<<2 = pointer to the table + month*5*2 = pointer to the table + 
month*10 
BX lr 


ARM64 


Listing 1.264: Optimizing GCC 4.9 ARM64 


month 

sxtw x0, wO 
; X0 = sign-extended input value 
adrp X1, .LANCHOR1 


add X1, x1, :lo12: .LANCHOR1 
; X1 = pointer to the table 
add x0, x0, x0, lsl 2 
; X0 = X04X0««2 = X0«-X0*4 = X0*5 
add x0, x1, x0, isl 1 
; XO = X1+X0<<1 = X1+X0*2 = pointer to the table + X0*10 
ret 


SXTW is used for sign-extension and promoting input 32-bit value into a 64-bit one 
and storing it in XO. 


ADRP/ADD pair is used for loading the address of the table. 


The ADD instructions also has a LSL suffix, which helps with multiplications. 


MIPS 
Listing 1.265: Optimizing GCC 4.4.5 (IDA) 
.globl get month2 
get month2: 
; $a0=month 
sll $v0, $a0, 3 
; $vO = $a0««3 = month*8 
sll $a0, 1 


; $a0 = $a0««1 = month*2 

addu $a0, $v0 
; $a0 = month*2+month*8 = month*10 
; load address of the table: 


la $v0, month2 
; sum up table address and index we calculated and return: 
jr $ra 


addu $v0, $a0 


month2: .ascii "January"<0> 
.byte 0, 0 
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aFebruary: .ascii "February"«0» 
.byte 0 

aMarch: .ascii "March"<0> 
.byte 0, 0, 0, 0 

aApril: .ascii "April"<0> 
.byte 0, 0, 0, 0 

aMay: .ascii "May"<0> 
.byte 0, 0, 0, 0, 0, 0 

aJune: .ascii "June"<0> 
.byte 0, 0, 0, 0, 0 

aJuly: .ascii "July"<0> 
.byte 0, 0, 0, 0, 0 

aAugust: .ascii "August"<0> 
.byte 0, 0, 0 

aSeptember: .ascii "September"<0> 

a0ctober: „ascii "October"<0> 
.byte 0, 0 

aNovember : .ascii "November"«0» 
.byte 0 

aDecember: .ascii "December"«0» 


.byte 0, 0, 0, 0, 0, 0, 0, 0, 0 


Conclusion 


This is a bit old-school technique to store text strings. You may find a lot of it in 
Oracle RDBMS, for example. It's hard to say if it'S worth doing on modern computers. 
Nevertheless, it is a good example of arrays, so it was added to this book. 


1.26.8 Conclusion 


An array is a pack of values in memory located adjacently. 
It's true for any element type, including structures. 
Access to a specific array element is just a calculation of its address. 


So, a pointer to an array and address of a first element—is the same thing. This is 
why ptr[0] and *ptr expressions are equivalent in C/C++. It's interesting to note 
that Hex-Rays often replaces the first by the second. It does so when it have no 
idea that it works with pointer to the whole array, and thinks that this is a pointer to 
single variable. 


1.26.9 Exercises 
* http://challenges.re/62 
* http://challenges.re/63 
* http://challenges.re/64 
* http://challenges.re/65 
* http://challenges.re/66 
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1.27 Example: a bug in Angband 


An ancient rogue-like game from 1990's 135 had a nice bug in the spirit of the "Road- 
side Picnic”*3 by Strugatsky brothers or “The Lost Room" TV series!3”: 


The frog-knows version was abundant of bugs. The funniest of 
them led to a cunning technique of cheating the game, that was called 
"mushroom farming". If there were more than a certain number (about 
five hundred) of objects in the labyrinth, the game would break, and 
many old things turned into objects thrown to the floor. Accordingly, 
the player went into the maze, he made such longitudinal grooves 
there (with a special spell), and walked along the grooves, creating 
mushrooms with another special spell. When there were a lot of mush- 
rooms, the player put and took, put and took some useful item, and 
mushrooms one by one turned into this subject. After that, the player 
returned with hundreds of copies of the useful item. 


(Misha “tiphareth” Verbitsky, http://imperium.lenin.ru/CEBEP/arc/3/lightmusic/ 
light.htm) 


And some information from usenet: 


From: be...@uswest.com (George Bell) 
Subject: [Angband] Multiple artifact copies found (bug?) 
Date: Fri, 23 Jul 1993 15:55:08 GMT 


Up to 2000 ft I found only 4 artifacts, now my house is littered with the 

suckers (FYI, most I've gotten from killing nasties, like Dracoliches and 7 
S the 

like). Something really weird is happening now, as I found multiple 

copies of the same artifact! My half-elf ranger is down at 2400 ft on one 

level which is particularly nasty. There is a graveyard plus monsters 

surrounded by permanent rock and 2 or 3 other special monster rooms! I did 

so much slashing with my favorite weapon, Crisdurian, that I filled several 

rooms nearly to the brim with treasure (as usual, mostly junk). 


Then, when I found a way into the big vault, I noticed some of the treasure 
had already been identified (in fact it looked strangely familiar!). Then 2 
VI 
found *two* Short Swords named Sting (1d6) (+7,+8), and I just ran across a 
third copy! I have seen multiple copies of Gurthang on this level as well. 
Is there some limit on the number of items per level which I have exceeded? 
This sounds reasonable as all multiple copies I have seen come from this 7 
S level. 


I'm playing PC angband. Anybody else had this problem? 


-George Bell 


I35https://en.wikipedia.org/wiki/Angband (video game), http://rephial.org/ 
136https://en.wikipedia.org/wiki/Roadside Picnic 
137https://en.wikipedia.org/wiki/The Lost Room 
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Help! I need a Rod of Restore Life Levels, if there is such a thing. 2 
S These 
Graveyards are nasty (Black Reavers and some speed 2 wraith in particular). 


(https://groups.google.com/forum/#! original/rec.games.moria/jItmf rdGyL8/ 
8csctQqA7PQJ ) 


From: Ceri <cm...Gandrew.cmu.edu> 
Subject: Re: [Angband] Multiple artifact copies found (bug?) 
Date: Fri, 23 Jul 1993 23:32:20 -0400 


welcome to the mush bug. if there are more than 256 items 
on the floor, things start duplicating. learn to harness 
this power and you will win shortly :> 


- -Rick 


( google groups ) 


From: nwe...@soda.berkeley.edu (Nicholas C. Weaver) 
Subject: Re: [Angband] Multiple artifact copies found (bug?) 
Date: 24 Jul 1993 18:18:05 GMT 


In article <74348474...@unixl.andrew.cmu.edu> Ceri <cm...@andrew.cmu.edu> 7 
S writes: 

>welcome to the mush bug. if there are more than 256 items 

>on the floor, things start duplicating. learn to harness 

>this power and you will win shortly :> 

> 

>- -Rick 


QUestion on this. Is it only the first 256 items which get 
duplicated? What about the original items? Etc ETc ETc... 


Oh, for those who like to know about bugs, though, the -n option 
(start new character) has the following behavior: 


(this is in version 2.4.Frog.knows on unix) 
If you hit controll-p, you keep your old stats. 
YOu loose all record of artifacts founds and named monsters killed. 


YOu loose all items you are carrying (they get turned into error in 
objid()s ). 


You loose your gold. 
You KEEP all the stuff in your house. 


If you kill something, and then quaff a potion of restore life 
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levels, you are back up to where you were before in EXPERIENCE POINTS!! 


Gaining spells will not work right after this, unless you have a 
gain int item (for spellcasters) or gain wis item (for priests/palidans), 7 
y in 
which case after performing the above, then take the item back on and off, 
you will be able to learn spells normally again. 


This can be exploited, if you are a REAL HOZER (like me), into 
getting multiple artifacts early on. Just get to a level where you can 
pound wormtongue into the ground, kill him, go up, drop your stuff in your 
house, buy a few potions of restore exp and high value spellbooks with your 
leftover gold, angband -n yourself back to what you were before, and repeat 
the process. Yes, you CAN kill wormtongue multiple times. :) 


This also allows the creation of a human rogue with dunedain 2 
S warrior 
starting stats. 


Of course, such practices are evil, vile, and disgusting. I take 7 
S no 
liability for the results of spreading this information. Yeah, it's Y 
y another 
bug to go onto the pile. 


Nicholas C. Weaver perpetual ensign guppy nwe...@soda.berkeley. 7 
y edu 
It is a tale, told by an idiot, full of sound and fury, .signifying 2 
Ss nothing. 


Since C evolved out of B, and a C+ is close to a B, 
does that mean that C++ is a devolution of the language? 


(https://groups.google.com/forum/#! original/rec.games.moria/jItmf rdGyL8/ 


FoQeiccewHAJ ) 
The whole thread. 


The author of these lines has found the version with the bug (2.4 fk) 138, and we can 
clearly see how the global arrays are declared: 


/* Number of dungeon objects */ 
#define MAX DUNGEON OBJ 423 


intl6 sorted objects[MAX DUNGEON 0BJ]; 


/* Identified objects flags */ 
int8u object ident[OBJECT IDENT SIZE]; 

int16 t level [MAX 0BJ LEVEL-*41]; 

inven type t list[MAX TALLOC] ; 


138http://rephial.org/release/2.4.fk, https://yurichev.com/mirrors/angband-2.4.fk.tar 
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inven type inventory[INVEN ARRAY SIZE]; 


Perhaps this is a reason. The MAX DUNGEON 0BJ constant is too small. Perhaps, au- 
thors should use linked lists or other data structures, which are unlimited by size. 
But arrays are simpler to use. 


Another example of buffer overflow over globally defined arrays: 3.31 on page 813. 


1.28 Manipulating specific bit(s) 


A lot of functions define their input arguments as flags in bit fields. 
Of course, they could be substituted by a set of bool-typed variables, but it is not 


frugally. 

1.28.1 Specific bit checking 
x86 

Win32 API example: 


HANDLE fh; 


fh=CreateFile ("file", GENERIC WRITE | GENERIC READ, 2 
GQ FILE SHARE READ, NULL, OPEN ALWAYS, FILE ATTRIBUTE NORMAL, NULL); 


We get (MSVC 2010): 
Listing 1.266: MSVC 2010 


push 0 

push 128 ; 00000080H 
push 4 

push 0 

push 1 

push -1073741824 ; C0000000H 
push OFFSET $SG78813 

call DWORD PTR imp CreateFileAQ28 
mov DWORD PTR fh$[ebp], eax 


Let's take a look in WinNT.h: 
Listing 1.267: WinNT.h 


#define GENERIC READ (0x80000000L) 
#define GENERIC WRITE (0x40000000L) 
#define GENERIC EXECUTE (0x20000000L) 
define GENERIC ALL (0x10000000L) 


Everything is clear, GENERIC_READ | GENERIC_WRITE = 0x80000000 | 0x40000000 
= 0xC0000000, and that value is used as the second argument for the CreateFile()*°°function. 


139msdn.microsoft.com/en-us/library/aa363858(VS.85).aspx 
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How would CreateFile() check these flags? 


If we look in KERNEL32.DLL in Windows XP SP3 x86, we'll find this fragment of code 
in CreateFileW: 


Listing 1.268: KERNEL32.DLL (Windows XP SP3 x86) 


.text:7C83D429 test byte ptr [ebp+dwDesiredAccess+3], 40h 
.text:7C83D42D mov [ebp-var 8], 1 

.text:7C83D434 jz short loc 7C83D417 

.text:7C83D436 jmp loc 7C810817 


Here we see the TEST instruction, however it doesn't take the whole second argu- 
ment, 

but only the most significant byte (ebp+dwDesiredAccess+3) and checks it for flag 
0x40 (which implies the GENERIC WRITE flag here). 


TEST is basically the same instruction as AND, but without saving the result (recall 
the fact CMP is merely the same as SUB, but without saving the result (1.12.4 on 
page 113)). 


The logic of this code fragment is as follows: 


if ((dwDesiredAccess&0x40000000) == 0) goto loc 7C83D417 


If AND instruction leaves this bit, the ZF flag is to be cleared and the JZ conditional 
jump is not to be triggered. The conditional jump is triggered only if the 0x40000000 
bit is absent in dwDesiredAccess variable —then the result of AND is O, ZF is to be 
set and the conditional jump is to be triggered. 


Let's try GCC 4.4.1 and Linux: 


#include <stdio.h> 
#include <fcntl.h> 


void main() 


{ 
int handle; 
handle=open ("file", O_RDWR | O CREAT); 
$; 
We get: 
Listing 1.269: GCC 4.4.1 
public main 
main proc near 
var_20 = dword ptr -20h 
var 1C = dword ptr -1Ch 
var 4 - dword ptr -4 
push ebp 
mov ebp, esp 
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and esp, OFFFFFFFOh 
sub esp, 20h 
mov [esp*20h«var 1C], 42h 
mov [esp+20h+var 20], offset aFile ; "file" 
call open 
mov [esp+20h+var 4], eax 
leave 
retn 
main endp 


If we take a look in the open() function in the libc.so.6 library, it is only a syscall: 


Listing 1.270: open() (libc.so.6) 


.text:000BE69B mov edx, [esp+4+mode] ; mode 
.text:000BE69F mov ecx, [espt+4+flags] ; flags 

. text :000BE6A3 mov ebx, [esp+4+filename] ; filename 
.text:000BE6A7 mov eax, 5 

.text:000BE6AC int 80h ; LINUX - sys open 


So, the bit fields for open() are apparently checked somewhere in the Linux kernel. 


Of course, it is easy to download both Glibc and the Linux kernel source code, but 
we are interested in understanding the matter without it. 


So, as of Linux 2.6, when the sys open syscall is called, control eventually passes to 
do sys open, and from there—to the do filp open() function (it's located in the 
kernel source tree in fs/namei.c). 


N.B. Aside from passing arguments via the stack, there is also a method of passing 
some of them via registers. This is also called fastcall (6.1.3 on page 934). This works 
faster since CPU does not need to access the stack in memory to read argument 
values. GCC has the option regparm!*”, through which it's possible to set the number 
of arguments that can be passed via registers. 


The Linux 2.6 kernel is compiled with -mregparm=3 option !^! 142, 


What this means to us is that the first 3 arguments are to be passed via registers 
EAX, EDX and ECX, and the rest via the stack. Of course, if the number of arguments 
is less than 3, only part of registers set is to be used. 


So, let's download Linux Kernel 2.6.31, compile it in Ubuntu: make vmlinux, open it 
in IDA, and find the do filp open() function. At the beginning, we see (the com- 
ments are mine): 


Listing 1.271: do filp open() (linux kernel 2.6.31) 


do filp open proc near 
push ebp 
mov ebp, esp 
push edi 


140 ohse.de/uwe/articles/gcc-attributes.html#func-regparm 
14lkernelnewbies.org/Linux_2_6_20++thead-042c62f290834eb1fe0a1942bbf5bb9a4accbc8f 


142See also arch/x86/include/asm/calling.h file in kernel tree 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


385 


push esi 

push ebx 

mov ebx, ecx 

add ebx, 1 

sub esp, 98h 

mov esi, [ebp«arg 4] ; acc mode (5th argument) 
test bl, 3 

mov [ebp+var_80], eax ; dfd (1th argument) 

mov [ebp+var_7C], edx ; pathname (2th argument) 
mov [ebp-var 78], ecx ; open flag (3th argument) 
jnz short loc COIEF684 

mov ebx, ecx ; ebx «- open flag 


GCC saves the values of the first 3 arguments in the local stack. If that wasn't 
done, the compiler would not touch these registers, and that would be too tight 
environment for the compiler's register allocator. 


Let's find this fragment of code: 


Listing 1.272: do filp open() (linux kernel 2.6.31) 


loc COIEF684: ; CODE XREF: do filp open+4F 
test bl, 40h ; 0 CREAT 
jnz loc COIEF810 
mov edi, ebx 
shr edi, 11h 
xor edi, 1 
and edi, 1 
test ebx, 10000h 
jz short loc COIEF6D3 
or edi, 2 


0x40—is what the 0 CREAT macro equals to. open flag gets checked for the pres- 
ence of the 0x40 bit, and if this bit is 1, the next JNZ instruction is triggered. 
ARM 
The 0 CREAT bit is checked differently in Linux kernel 3.8.0. 
Listing 1.273: linux kernel 3.8.0 


struct file *do filp open(int dfd, struct filename *pathname, 
const struct open flags *op) 


1 
v filp = path openat(dfd, pathname, &nd, op, flags | LOOKUP RCU); 
static struct file *path openat(int dfd, struct filename *pathname, 


struct nameidata *nd, const struct open flags *op, int 7 
S flags) 
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error - 


do last(nd, &path, file, op, &opened, pathname); 


static int do last(struct nameidata *nd, struct path *path, 


struct file *file, const struct open flags *op, 
int *opened, struct filename *name) 


if (!(open flag € O CREAT)) 4 


v ) else 1 


error = lookup fast(nd, path, &inode) ; 


error = complete walk(nd); 


Here is how the kernel compiled for ARM mode looks in IDA: 


Listing 1.274: do_last() from vmlinux (IDA) 


.text: 


CO169EA8 MOV R9, R3 ; R3 - (4th argument) open flag 
.text:C0169EDA LDR R6, [R9] ; R6 - open flag 
.text:C0169F68 TST R6, 40x40 ; jumptable C0169F00 default case 
.text:C0169F6C BNE loc C016A128 
.text:C0169F70 LDR R2, [R4,#0x10] 

.text:C0169F74 ADD R12, R4, #8 

. text: C0169F78 LDR R3, [R4,#0xC] 

. text: CO169F7C MOV RO, R4 

. text: C0169F80 STR R12, [R11,#var_50] 
. text: C0169F84 LDRB R3, [R2,R3] 

. text: C0169F88 MOV R2, R8 

. text: CO169F8C CMP R3, #0 

. text: C0169F90 ORRNE R1, R1, #3 
.text:C0169F94 STRNE R1, [R4,#0x24] 
.text:C0169F98 ANDS R3, R6, #0x200000 
.text:C0169F9C MOV R1, R12 
.text:C0169FA0 LDRNE R3, [R4,#0x24] 
.text:C0169FA4 ANDNE R3, R3, #1 
.text:C0169FA8 EORNE R3, R3, #1 
.text:C0169FAC STR R3, [R11,£var 54] 
.text:C0169FBO SUB R3, R11, £-var 38 
.text:C0169FB4 BL lookup fast 
.text:C016A128 loc C016A128 ; CODE XREF: do last.isra.14+DC 
.text:C016A128 MOV RO, R4 
.text:C016A12C BL complete walk 
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TST is analogous to the TEST instruction in x86. We can "spot" visually this code frag- 


ment by the fact the Lookup fast() isto be executed in one case and complete walk() 


in the other. This corresponds to the source code of the do last() function. The 
0 CREAT macro equals to 0x40 here too. 


1.28.2 Setting and clearing specific bits 


For example: 


#include <stdio.h> 


#define SET BIT(var, bit) ((var) (bit) ) 


#define IS SET(flag, bit) ((flag) € (bit) ) 
|= 
#define REMOVE BIT(var, bit) ((var) & -(bit)) 


int f(int a) 


1 
int rt=a; 
SET BIT (rt, 0x4000); 
REMOVE BIT (rt, 0x200); 
return rt; 

ur 

int main() 

1 
f(0x12340678); 

i 

x86 


Non-optimizing MSVC 


We get (MSVC 2010): 
Listing 1.275: MSVC 2010 


_rt$ = -4 ; size = 4 
_ag = 8 ; size = 4 
f PROC 
push ebp 
mov ebp, esp 
push ecx 


mov eax, DWORD PTR a$[ebp] 

mov DWORD PTR rt$[ebp], eax 

mov ecx, DWORD PTR rt$[ebp] 

or ecx, 16384 ; 00004000H 
mov DWORD PTR rt$[ebp], ecx 
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mov edx, DWORD PTR rt$[ebp] 
and edx, -513 ; fffffdffH 
mov DWORD PTR rt$[ebp], edx 
mov eax, DWORD PTR rt$[ebp] 


mov esp, ebp 
pop ebp 
ret 0 

f ENDP 


The OR instruction sets one bit into a register while ignoring other 1 bits. 


AND resets one bit. It can be said that AND just copies all bits except one. Indeed, in 
the second AND operand only the bits that need to be saved are set, just the one do 
not want to copy is not (which is 0 in the bitmask). It is the easier way to memorize 
the logic. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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OllyDbg 


Let's try this example in OllyDbg. 

First, let’s see the binary form of the constants we are going to use: 

0x200 (0b00000000000000000001000000000) (i.e., the 10th bit (counting from 1st)) 
Inverted 0x200 is OXFFFFFDFF (0b11111111111111111110111111111). 

0x4000 (0200000000000000100000000000000) (i.e., the 15th bit). 


The input value is: 0x12340678 (0b10010001101000000011001111000). We see 
how it's loaded: 


CP nain thread, module set reset 
PUSH EBP 
MOU EBP,ESP 
PUSH ECX 
MOU EAX, DWORD PTR SS: CARG.1] 
MOU DWORD PTR SS:EtLOCRL.11,ERX 
MOV ECX, DWORD PTR SS:CLOCAL.1] 
OR ECX, 60004008 
DWORD PTR SS: CLOCAL.1],ECx 
EDX, DWORD PTR SS: [LOCAL. 13 
EDX, FFFFFOFF E kin : 
EAR DUORD PTR SS: ECOCAL» 14 p koanta 
, : . bit B(FFFFFFFF) 
U ESP,EBP ; bit @(FFFFFFFF) 


bit B(FFFFFFFF) 
bit B(FFFFFFFF) 


- S bit ?EFDDOaatFFF) 
Inn=a0004000 f 
ECX=12340678 : BIS BIFEFFEFFEJ 


SUCCESS 
,PE,GE,LE) hd 


Ə hp RETURN from set, 
HC ANI 
RETURN from set, 
ASCII ”pNI” 


Figure 1.94: OllyDbg: value is loaded into ECX 
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OR got executed: 


PUSH EBP 
MOU EBP,ESP 
PUSH ECX 

MOV EAX, DWORD PTR SS: CARG. 1] 
MOU DWORD PTR SS: CLOCAL. 11, EAX 
MOV ECX, DWORD PTR SS: [LOCAL. 11 
OR ECX, 60004999 

MOU DWORD PTR SS:ELOCRL.11,ECX 
MOV EDX,OWORD PTR SS:CLOCAL.1] 
AND EDX, FFFFFOFF 

MOV DWORD PTR SS: CLOCAL.11,EDx 
MOV EAX,DWORD PTR SS: [LOCAL. 1] 
MOU ESP, EBP 

POP EBP 

RETN 


DOS 


> B(FFFFFFFF) 
7EFODGGG( FFF) 


3 
ECX=1234467 t GCFFFFFFFF) 


8 
Stack [BB2FFC388]=12340678 


)O- nm DTo00 


UCCESS 
EFL ^ PE, GE, G) 


8 ef j y RETURN from set. 
HC] hNI 


RETURN from set, 
ASCII ”pNI” 


ico Co Co C» 


Figure 1.95: OllyDbg: OR executed 


15th bit is set: 0x12344678 (0b10010001101000100011001111000). 
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The value is reloaded again (because the compiler is not in optimizing mode): 


CPU - main threa ule set reset a O) x| 
PUSH_EBP 

MOV EBP,ESP 

PUSH_ECX 

MOU EAX, DWORD PTR SS: CARG.1] 
MOV DWORD PTR SS: CLOCAL.1],EAX 
MOV ECX, DWORD PTR SS: [LOCAL. 1] 
OR ECX, 00004006 


MOY DWORD PTR SS: [LOCAL.1],ECX 
MOU EDX, DWORD PTR SS: [LOCAL.1] 
AND EDX, FFFFFDFF 


" 
MOU DWORD PTR SS:LLOCRL.11,EDX 
MOU EAX, DWORD PTR SS: CLOCAL. 11 
NOU ESP, EBP 

POP EBP 

RETN 


t ØLFFFFFFFF) 

t B(FFFFFFFF) 

@( FFFFFFFF) 

t BLFFFFFFFF) 
: 7EFDDOGOLFFF) 

it B(FFFFFFFF) 


Inm-FFFFFDFF 
EDX=12344678 


IDANMNDDO 
DOS 


D? OF 7 RETURN from set. 
4E 5D B 
RETURN from set, 


ASCII "pN1" 


Figure 1.96: OllyDbg: value has been reloaded into EDX 
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AND got executed: 


PUSH EEP 
HOU EBP, ESP 
MOU ERS DWORD PTR SS: CARG. 11 RRE 
MOU DWORD PTR SS:CLOCAL. 11, EAX 12944476 
MOU ECX, DWORD PTR SS: LLOCRL. 11 : 

OR ECX, B0084998 

MOU DUORD PTR SS:LLOCRL.11,ECX 
MOU EDX, DWORD PTR SS: LLOCRL. 11 
AND EDX, FFFFFOFF 

MOU PTR SS:CLOCAL. 11, EDX 
MOU EAX, DWORD PTR SS: LOCAL. 1] 
MOU ESP, EBP 

POP EBP 

RETN 


pa au E 


E 
IP @6E3161F 


@(FFFFFFFF) 
Bt FFFFFFFF) 
@( FFFFFFFF) 
OLFFFFFFFF) 
7EFDDOGO(FFF) 
BCFFFFFFFF) 


O-orn noo mmmmm 


M mo 


FF FFIFF FF FF 
F FF FF G1 66 B8 


8 Ser 
HCJ hN3 


TEN 


RETURN from set. 


ASCII ”pNI” 


Figure 1.97: OllyDbg: AND executed 


The 10th bit has been cleared (or, in other words, all bits were left except the 10th) 
and the final value now is 
0x12344478 (0b10010001101000100010001111000). 


Optimizing MSVC 


If we compile it in MSVC with optimization turned on (/0x), the code is even shorter: 


Listing 1.276: Optimizing MSVC 


_a$ = 8 ; size = 4 
f PROC 
mov eax, DWORD PTR _a$[esp-4] 
and eax, -513 ; fffffdffH 
or eax, 16384 ; 00004000H 
ret 0 
f ENDP 


Non-optimizing GCC 


Let's try GCC 4.4.1 without optimization: 
Listing 1.277: Non-optimizing GCC 


public f 
f proc near 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


393 


var 4 - dword ptr -4 

arg 0 - dword ptr 8 
push ebp 
mov ebp, esp 
sub esp, 10h 
mov eax, [ebp«arg 0] 
mov [ebp+var_4], eax 
or [ebp+var_4], 4000h 
and [ebp+var_4], OFFFFFDFFh 
mov eax, [ebp+var_4] 
leave 
retn 

f endp 


There is a redundant code present, however, it is shorter than the MSVC version 
without optimization. 

Now let’s try GCC with optimization turned on -03: 

Optimizing GCC 


Listing 1.278: Optimizing GCC 


public f 

f proc near 

arg 0 - dword ptr 8 
push ebp 
mov ebp, esp 
mov eax, [ebp«arg 0] 
pop ebp 
or ah, 40h 
and ah, OFDh 
retn 

f endp 


That’s shorter. It is worth noting the compiler works with the EAX register part via 
the AH register—that is the EAX register part from the 8th to the 15th bits included. 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RAX*64 


EAX 


AX 
AH | AL 


N.B. The 16-bit CPU 8086 accumulator was named AX and consisted of two 8-bit 
halves—AL (lower byte) and AH (higher byte). In 80386 almost all registers were 
extended to 32-bit, the accumulator was named EAX, but forthe sake of compatibility, 
its older parts may be still accessed as AX/AH/AL. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Since all x86 CPUs are successors of the 16-bit 8086 CPU, these o/der 16-bit opcodes 
are shorter than the newer 32-bit ones. That's why the or ah, 40h instruction oc- 
cupies only 3 bytes. It would be more logical way to emit here or eax, 04000h but 
that is 5 bytes, or even 6 (in case the register in the first operand is not EAX). 


Optimizing GCC and regparm 


It would be even shorter if to turn on the -03 optimization flag and also set regparm=3. 


Listing 1.279: Optimizing GCC 


public f 

f proc near 
push ebp 
or ah, 40h 
mov ebp, esp 
and ah, OFDh 
pop ebp 
retn 

f endp 


Indeed, the first argument is already loaded in EAX, so it is possible to work with it in- 
place. It is worth noting that both the function prologue (push ebp / mov ebp,esp) 
and epilogue (pop ebp) can easily be omitted here, but GCC probably is not good 
enough to do such code size optimizations. However, such short functions are better 
to be inlined functions (3.14 on page 634). 


ARM + Optimizing Keil 6/2013 (ARM mode) 
Listing 1.280: Optimizing Keil 6/2013 (ARM mode) 


02 0C CO E3 BIC RO, RO, #0x200 
01 09 80 E3 ORR RO, RO, #0x4000 
1E FF 2F El BX LR 


BIC (Bltwise bit Clear) is an instruction for clearing specific bits. This is just like 
the AND instruction, but with inverted operand. l.e., it's analogous to a NOT +AND 
instruction pair. 


ORR is "logical or", analogous to OR in x86. 


So far it's easy. 


ARM + Optimizing Keil 6/2013 (Thumb mode) 
Listing 1.281: Optimizing Keil 6/2013 (Thumb mode) 


01 21 89 03 MOVS R1, 0x4000 

08 43 ORRS RO, R1 

49 11 ASRS R1, Rl, #5 ; generate 0x200 and place to R1 
88 43 BICS RO, R1 

70 47 BX LR 
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Seems like Keil decided that the code in Thumb mode, making 0x200 from 0x4000, 
is more compact than the code for writing 0x200 to an arbitrary register. 


So that is why, with the help of ASRS (arithmetic shift right), this value is calculated 
as 0x4000 > 5. 


ARM + Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Listing 1.282: Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


42 0C CO E3 BIC RO, RO, #0x4200 
01 09 80 E3 ORR RO, RO, #0x4000 
1E FF 2F El BX LR 


The code that was generated by LLVM, in source code form could be something like 
this: 


REMOVE BIT (rt, 0x4200); 
SET BIT (rt, 0x4000); 


And it does exactly what we need. But why 0x4200? Perhaps that an artifact from 
LLVM's optimizer 14°. 


Probably a compiler’s optimizer error, but the generated code works correctly any- 
Way. 


You can read more about compiler anomalies here (11.5 on page 1258). 
Optimizing Xcode 4.6.3 (LLVM) for Thumb mode generates the same code. 


ARM: more about the BIC instruction 


Let’s rework the example slightly: 


int f(int a) 


{ 
int rt=a; 
REMOVE BIT (rt, 0x1234); 
return rt; 

F; 


Then the optimizing Keil 5.03 in ARM mode does: 


f PROC 
BIC r0, r0,#0x1000 
BIC rO, r0,#0x234 
BX lr 


ENDP 


1431t was LLVM build 2410.2.00 bundled with Apple Xcode 4.6.3 
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There are two BIC instructions, i.e., bits 0x1234 are cleared in two passes. 


This is because it's not possible to encode 0x1234 in a BIC instruction, but it's possi- 

ble to encode 0x1000 and 0x234. 

ARM64: Optimizing GCC (Linaro) 4.9 

Optimizing GCCcompiling for ARM64 can use the AND instruction instead of BIC: 
Listing 1.283: Optimizing GCC (Linaro) 4.9 


f: 
and w0, w0, -513 ; OxFFFFFFFFFFFFFDFF 
orr w0, w0, 16384 ; 0x4000 
ret 


ARM64: Non-optimizing GCC (Linaro) 4.9 
Non-optimizing GCC generates more redundant code, but works just like optimized: 


Listing 1.284: Non-optimizing GCC (Linaro) 4.9 


f: 
sub sp, sp, #32 
str w0, [sp,12] 
ldr w0, [sp,12] 
str w0, [sp,28] 
ldr w0, [sp,28] 
orr w0, w0, 16384 ; 0x4000 
str w0, [sp,28] 
ldr w0, [sp,28] 
and w0, w0, -513 ; OXEFEEFEFEREREEDER 
str w0, [sp,28] 
ldr w0, [sp,28] 
add sp, sp, 32 
ret 
MIPS 
Listing 1.285: Optimizing GCC 4.4.5 (IDA) 
f: 
; $a0-a 
ori $a0, 0x4000 
; $a0-a |0x4000 
li $v0, OxFFFFFDFF 
jr $ra 
and $v0, $a0, $v0 


; at finish: $v0 = $a0 € $v0 = a|0x4000 € OxFFFFFDFF 


ORI is, of course, the OR operation. "I" in the instruction name means that the value 
is embedded in the machine code. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


397 
But after that we have AND. There is no way to use ANDI because it's not possible to 
embed the OxFFFFFDFF number in a single instruction, so the compiler has to load 
OxFFFFFDFF into register $VO first and then generates AND which takes all its values 
from registers. 


1.28.3 Shifts 


Bit shifts in C/C++ are implemented using « and > operators. The x86 ISA has 
the SHL (SHift Left) and SHR (SHift Right) instructions for this. Shift instructions are 
often used in division and multiplications by powers of two: 2" (e.g., 1, 2, 4, 8, etc): 
1.24.1 on page 268, 1.24.2 on page 274. 


Shifting operations are also so important because they are often used for specific bit 
isolation or for constructing a value of several scattered bits. 


1.28.4 Setting and clearing specific bits: FPU example 
Here is how bits are located in the float type in IEEE 754 form: 


3130 2322 0 


S| exponent mantissa or fraction 


(S — sign) 


The sign of number is in the MSB!^^, Will it be possible to change the sign of a 
floating point number without any FPU instructions? 


#include <stdio.h> 


float my_abs (float i) 


{ 
unsigned int tmp=(*(unsigned int*)&i) & Ox7FFFFFFF; 
return *(float*)&tmp; 

}; 

float set_sign (float i) 

{ 
unsigned int tmp=(*(unsigned int*)&i) | 0x80000000; 
return *(float*)&tmp; 

}; 

float negate (float i) 

{ 
unsigned int tmp=(*(unsigned int*)&i) ^ 0x80000000; 
return *(float*)&tmp; 

}; 

int main() 

{ 


printf ("my_abs():\n"); 


144Most Significant Bit 
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printf ("%f\n", my abs (123.456)); 
printf ("%f\n", my abs (-456.123)); 
printf ("set sign():An"); 

printf ("%f\n", set sign (123.456)); 
printf ("%f\n", set sign (-456.123)); 
printf ("negate():\n"); 

printf ("%f\n", negate (123.456)); 
printf ("%f\n", negate (-456.123)); 


ur 


We need this trickery in C/C++ to copy to/from float value without actual conver- 
sion. So there are three functions: my abs() resets MSB; set sign() sets MSB and 
negate() flips it. 


XOR can be used to flip a bit. 


x86 
The code is pretty straightforward: 
Listing 1.286: Optimizing MSVC 2012 


_tmp$ = 8 
_i$ = 8 
_my_abs PROC 
and DWORD PTR i$[esp-4], 2147483647 ; 7fffffffH 
fld DWORD PTR tmp$[esp-4] 
ret 0 
my abs ENDP 
tmp$ - 8 
_1$ = 8 
Set sign PROC 
or DWORD: PTR -1$ Lesp-4]; =2147483648; 80000000H 
fld DWORD PTR tmp$[esp-4] 
ret 0 


set sign ENDP 


_tmp$ = 8 

_i¢ = 8 

negate PROC 
xor DWORD PTR _i$[esp-4], -2147483648 ; 30000000H 
fld DWORD PTR tmp$[esp-4] 
ret 0 


negate ENDP 


An input value of type float is taken from the stack, but treated as an integer value. 
AND and OR reset and set the desired bit. XOR flips it. 


Finally, the modified value is loaded into STO, because floating-point numbers are 
returned in this register. 


Now let's try optimizing MSVC 2012 for x64: 
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Listing 1.287: Optimizing MSVC 2012 x64 


tmp$ = 8 

i$ = 8 

my abs PROC 
movss DWORD PTR [rsp+8], xmmO 
mov eax, DWORD PTR i$[rsp] 
btr eax, 31 
mov DWORD PTR tmp$[rsp], eax 
movss xmm0, DWORD PTR tmp$[rsp] 
ret 0 

my abs ENDP 

TEXT ENDS 

tmp$ = 8 

i$ = 8 


set_sign PROC 
movss DWORD PTR [rsp+8], xmmO 


mov eax, DWORD PTR i$[rsp] 
bts eax, 31 

mov DWORD PTR tmp$[rsp], eax 
movss xmm0, DWORD PTR tmp$[rsp] 
ret 0 


set_sign ENDP 


tmp$ = 8 
ig = 8 
negate PROC 
movss DWORD PTR [rsp+8], xmmO 


mov eax, DWORD PTR i$[rsp] 
btc eax, 31 

mov DWORD PTR tmp$[rsp], eax 
movss xmm0, DWORD PTR tmp$[rsp] 
ret 0 


negate ENDP 


The input value is passed in XMMO, then it is copied into the local stack and then we 
see some instructions that are new to us: BTR, BTS, BTC. 


These instructions are used for resetting (BTR), setting (BTS) and inverting (or com- 
plementing: BTC) specific bits. The 31st bit is MSB, counting from O. 


Finally, the result is copied into XMMO, because floating point values are returned 
through XMMO in Win64 environment. 
MIPS 
GCC 4.4.5 for MIPS does mostly the same: 
Listing 1.288: Optimizing GCC 4.4.5 (IDA) 


my abs: 
; move from coprocessor 1: 
mfcl $v1, $f12 
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li $v0, Ox7FFFFFFF 
$v0=0x7FFFFFFF 
; do AND: 


and $v0, $v1 
; move to coprocessor 1: 
mtcl $vO, $f0 
; return 
jr $ra 
or gat, $zero ; branch delay slot 


set_sign: 
; move from coprocessor 1: 
mfcl $v0, $f12 
lui $v1, 0x8000 
$v1=0x80000000 
; do OR: 


or $v0O, $vl, $v0 
move to coprocessor 1: 
mtcl $v0O, $f0 


return 


jr $ra 
or $at, $zero ; branch delay slot 


negate: 
; move from coprocessor 1: 
mfcl $v0, $f12 
lui $v1, 0x8000 
$v1=0x80000000 
; do XOR: 


xor $vO, $vl, $v0 
; move to coprocessor 1: 
mtcl $vO, $f0 
; return 
jr $ra 
or $at, $zero ; branch delay slot 


One single LUI instruction is used to load 0x80000000 into a register, because LUI 
is clearing the low 16 bits and these are zeros in the constant, so one LUI without 
subsequent ORI is enough. 


ARM 
Optimizing Keil 6/2013 (ARM mode) 


Listing 1.289: Optimizing Keil 6/2013 (ARM mode) 


my abs PROC 

; Clear bit: 
BIC r0,r0,#0x80000000 
BX lr 
ENDP 
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set sign PROC 


; do OR: 
ORR r0, r0,#0x80000000 
BX lr 
ENDP 

negate PROC 

; do XOR: 
EOR ro, r0,#0x80000000 
BX lr 
ENDP 


So far so good. 
ARM has the BIC instruction, which explicitly clears specific bit(s). EOR is the ARM 
instruction name for XOR (“Exclusive OR”). 


Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.290: Optimizing Keil 6/2013 (Thumb mode) 


my abs PROC 

LSLS r0,r0,#1 
; rQ=i<<1 

LSRS r0,r0,#1 
; rQ=(i<<1)>>1 

BX lr 

ENDP 
set_sign PROC 

MOVS r1,#1 
; rl-1 

LSLS r1,r1,#31 
; r1=1<<31=0x80000000 

ORRS r0,r0,r1 
; rO-rO | 0x80000000 

BX lr 

ENDP 
negate PROC 

MOVS r1,#1 
; rl-1 

LSLS r1,r1,#31 
; r1=1<<31=0x80000000 

EORS ro,ro,rl 
; rO-rO ^ 0x80000000 

BX lr 

ENDP 


Thumb mode in ARM offers 16-bit instructions and not much data can be encoded 
in them, so here a MOVS/LSLS instruction pair is used for forming the 0x80000000 
constant. It works like this: 1 << 31 = 0280000000. 
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The code of my abs is weird and it effectively works like this expression: (i «« 1) »» 1. 
This statement looks meaningless. But nevertheless, when input «« 1 is executed, 
the MSB (sign bit) is just dropped. When the subsequent result »» 1 statement is 
executed, all bits are now in their own places, but MSB is zero, because all "new" 
bits appearing from the shift operations are always zeros. That is how the LSLS/LSRS 
instruction pair clears MSB. 


Optimizing GCC 4.6.3 (Raspberry Pi, ARM mode) 


Listing 1.291: Optimizing GCC 4.6.3 for Raspberry Pi (ARM mode) 


my abs 
; copy from SO to R2: 
FMRS R2, SO 
; clear bit: 
BIC R3, R2, #0x80000000 
; copy from R3 to S0: 
FMSR SO, R3 


set sign 
; copy from SO to R2: 
FMRS R2, SO 
; do OR: 
ORR R3, R2, #0x80000000 
; copy from R3 to S0: 
FMSR S0, R3 


negate 
; copy from SO to R2: 
FMRS R2, S0 
; do ADD: 
ADD R3, R2, #0x80000000 
; copy from R3 to S0: 
FMSR SO, R3 
BX LR 


Let's run Raspberry Pi Linux in QEMU and it emulates an ARM FPU, so S-registers are 
used here for floating point numbers instead of R-registers. 


The FMRS instruction copies data from GPR to the FPU and back. 


my abs()andset sign()looks as expected, but negate()? Why is there ADD instead 
of XOR? 


It's hard to believe, but the instruction ADD register, 0x80000000 works just like 
XOR register, 0x80000000. First of all, what's our goal? The goal is to flip the 
MSB, so let's forget about the XOR operation. From school-level mathematics we may 
recall that adding values like 1000 to other values never affects the last 3 digits. For 
example: 1234567 + 10000 = 1244567 (last 4 digits are never affected). 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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But here we operate in binary base and 
0x80000000 is 0b100000000000000000000000000000000, i.e., only the highest 
bit is set. 


Adding 0x80000000 to any value never affects the lowest 31 bits, but affects only 
the MSB. Adding 1 to 0 is resulting in 1. 


Adding 1 to 1 is resulting in 0b10 in binary form, but the 32th bit (counting from zero) 
gets dropped, because our registers are 32 bit wide, so the result is 0. That's why 
XOR can be replaced by ADD here. 


It's hard to say why GCC decided to do this, but it works correctly. 


1.28.5 Counting bits set to 1 


Here is a simple example of a function that calculates the number of bits set in the 
input value. 


This operation is also called "population count"1^*, 


#include <stdio.h> 


#define IS SET(flag, bit) ((flag) € (bit) ) 
int f(unsigned int a) 
{ 

int i; 

int rt-0; 

for (i20; i<32; i++) 

if (IS SET (a, 1««i)) 
rt++; 

return rt; 
}; 
int main() 
{ 

f(0x12345678); // test 
}; 


In this loop, the iteration count value i is counting from 0 to 31, so the 1 « i statement 
is counting from 1 to 0x80000000. Describing this operation in natural language, 
we would say shift 1 by n bits left. In other words, 1 « i statement consequently 
produces all possible bit positions in a 32-bit number. The freed bit at right is always 
cleared. 


Here is a table of all possible 1 «i for i — 0...31: 


145modern x86 CPUs (supporting SSE4) even have a POPCNT instruction for it 
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C/C++ expression | Power of two | Decimal form | Hexadecimal form 
1<0 20 1 1 

1«1 21 2 2 

1«2 27 4 4 

1«3 23 8 8 

1«4 24 16 0x10 

1«5 25 32 0x20 

1«6 26 64 0x40 

1<7 27 128 0x80 

1«8 28 256 0x100 

1«9 29 512 0x200 
1«10 ge 1024 0x400 

1<« 11 2H 2048 0x800 

i<12 212 4096 0x1000 
1<13 213 8192 0x2000 
1<14 pie 16384 0x4000 
1«15 215 32768 0x8000 

1<« 16 216 65536 0x10000 

] «17 217 131072 0x20000 
1<« 18 oe 262144 0x40000 
1<19 ge 524288 0x80000 
1<20 gee 1048576 0x100000 
l«21 271 2097152 0x200000 

1 << 22 922 4194304 0x400000 

1 < 23 me 8388608 0x800000 

1 < 24 24 16777216 0x1000000 
1 <« 25 a 33554432 0x2000000 
1 <« 26 226 67108864 0x4000000 
1< 27 a 134217728 0x8000000 
1 < 28 278 268435456 0x10000000 
1« 29 249 536870912 0x20000000 
1< 30 230 1073741824 | 0x40000000 
1«31 Do 2147483648 | 0x80000000 


These constant numbers (bit masks) very often appear in code and a practicing 
reverse engineer must be able to spot them quickly. 


Decimal numbers below 65536 and hexadecimal ones are very easy to memorize. 
While decimal numbers above 65536 are, probably, not worth memorizing. 


These constants are very often used for mapping flags to specific bits. For example, 
here is excerpt from ssl private.h from Apache 2.4.6 source code: 


fre 

* Define the SSL options 

T 
#define SSL OPT NONE (0) 
#define SSL OPT RELSET (1««0) 
#define SSL OPT STDENVVARS (1««1) 
define SSL OPT EXPORTCERTDATA (1««3) 
define SSL OPT FAKEBASICAUTH (1<<4) 
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define SSL OPT STRICTREQUIRE  (1««5) 
define SSL OPT OPTRENEGOTIATE (1<<6) 
#define SSL OPT LEGACYDNFORMAT (1<<7) 


Let's get back to our example. 
The IS SET macro checks bit presence in a. 


The IS SET macro is in fact the logical AND operation (AND) and it returns 0 if the 
specific bit is absent there, or the bit mask, if the bit is present. The if() operator in 
C/C++ triggers if the expression in it is not zero, it might be even 123456, that is 
why it always works correctly. 

x86 


MSVC 


Let's compile (MSVC 2010): 
Listing 1.292: MSVC 2010 


_rt$ = -8 ; size = 4 
i$ = -4 ; size = 4 
a$ = 8 ; size = 4 
_f PROC 
push ebp 
mov ebp, esp 
sub esp, 8 


mov DWORD PTR rt$[ebp], 0 
mov DWORD PTR i$[ebp], 0 
jmp SHORT $LN4@f 


$LN3Gf 
mov eax, DWORD PTR  i$[ebp] ; increment of i 
add eax, 1 
mov DWORD PTR i$[ebp], eax 
$LNAQGf 
cmp DWORD PTR i$[ebp], 32 ; 00000020H 
jge SHORT $LN2@f ; loop finished? 
mov edx, 1 
mov ecx, DWORD PTR i$[ebp] 
shl edx, cl ; EDX-EDX««CL 
and edx, DWORD PTR a$[ebp] 
je SHORT $LN1@f ; result of AND instruction was 0? 


then skip next instructions 


mov eax, DWORD PTR rt$[ebp] no, not zero 


add eax, 1 increment rt 
mov DWORD PTR rt$[ebp], eax 
$LN1Gf: 
jmp SHORT $LN3@f 
$LN2@f : 
mov eax, DWORD PTR rt$[ebp] 
mov esp, ebp 
pop ebp 
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ret 0 
f ENDP 
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OllyDbg 


Let's load this example into OllyDbg. Let the input value be 0x12345678. 
For i = 1, we see how i is loaded into ECX: 


ule shifts 


HOW EBP,ESP 

SUB ESP,S 

C745 FS gaga MOU DWORD PTR SS:ILDCRL.21,0 
C745 FC 88881 NOU DWORD PTR SS: CLOCAL. 11,6 
EB 09 JMP SHORT 00291081F 

8B45 FC HOW ERK, DWORD PTR SS: LOCAL. 1] 
83C8 ai ERX 

8945 FC BORD PTR SS:[LOCRL.11,ERX 
837D FC 20 DWORD PTR SS: CLOCAL. 11,20 
70 1A SHORT 60029103F : : 

BA üi8800000 EDX, 1 ' 98291020 a2 

8B4D FC EC, DWORD PTR SS: [LOCAL 13 E: X FFFFFFFF) 


» : X FFFFFFFF) 
AND EDX, DWORD PTR SS:LRRG.11 g 
Je SHORT 00291030 ; GL FFFFFFFF) 


TEFDDBBaLFFF) 
BCFFFFFFFF) 


GOcOcOOC 
gres 


weev 


< 


EDX-1 
Loop 96291616: loop variable CLOCAL.11](+1) 


RETURN from 


) 
on 


y D 


ecc 
cocoTn 


VON 
Oe 


eoo 


RETURN from 
ASCII "pho" 


DT. 
e 
DT. 


Figure 1.98: OllyDbg: i= 1, iis loaded into ECX 


EDX is 1. SHL is to be executed now. 
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SHL has been executed: 


83EC 68 
C745 F8 gaa 
tas FC 9600 


sees 


yve ey 


837D FC 20 
7D 1A 

BA 91909886 
8B4D FC 
D3E2 

2355 


74 09 
8B45 FS 


Stack ToOLaFSetis 12348070 
EDx=00000002 


s.e... 
< 


M. 


SUB ESP,8 

MOU DWORD PTR SS: [LOCAL.21,8 
MOU DWORD PTR SS: ELOCAL. 11, a 
JMP SHORT _0029101F 

MoU ERK, D DWORD PTR SS:CLOCAL. 1] 


DUGRD PTR SS: ELOCRL. 11, ERX 
DWORD PTR SS:LtLOCRL.11,28 
SHORT 60029103F 


EDX, 1 

ECX, DWORD PTR SS:CLOCAL. 11 
SHL EDX, CL 
AND EDX, DWORD PTR SS: ARG. 1] 


Je SHORT 66291630 
nou ERX. DWORD PTR SS:tLOCRL.21 


Loop 86291816: loop variable CLOCAL.11](+1) 


LI 


(Q hNQ 


IP 9029102F 


G(FFFFFFFF) 
it TEFDDaBatFFF) 
t B(FFFFFFFF) 


)O-( nm D 00 m 
DOS 


LastErr 


EFL aaaaa2a2 ( 


RETURN from 


RETURN from 
ASCII "pNo” 


Figure 1.99: OllyDbg: i=1, EDX =1«1=2 


EDX contain 1 « 1 (or 2). This is a bit mask. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


409 


AND sets ZF to 1, which implies that the input value (0x12345678) ANDed with 2 
results in O: 


CPU - main thread, module shifts Of x! 


C745 FS OOGAI MOV DWORD PTR SS:CLOCAL.2],6 
MOV DWORD PTR sal igs 11,0 
JMP SHORT 602918 

Hou ERN. D » DWORD PTR SS: CLOCAL. 1] 


DURO PTR SS: ELOCRL. 11, ERX 
Eco FC 28 DWORD PTR SS: CLOCAL.11,26 
SHORT 0029103F 


EDX, 1 
ECX, DWORD PTR SS: CLOCAL. 11 
EDX, CL 


D EDX,DWORD PTR SS: CARG. 1] o ES Ot FFFFFFFF) 


Je 00291030 TE : 
MOU EAX, DWORD PTR SS:CLOCAL.2] pala al di 


ADD EAX, 1 @(FFFFFFFF) 
— ‘ 7EFDD@@G( FFF) 


B r=0029103D - jumps to shift T at FFFFFFFF) 
Loop 868291816: loop variable CLOCAL.1 0 8 LastErr Ø A ERROR. SUCCESS 
EFL 00000246 (NO,NB,E,BE,NS,PE, GE, LE) ai 


cOmoooc 
2 aus 


6a ô digooooo 


io co m cc 
ee ee eee 
ES 


jm 


RETURN from shi 


¡DADO 
1 Im^ 
on 
Co Co CO 
¡DE 
JOO, 
DODO 
a: 


RETURN from shi 
ASCII "pNa” 


"T 
IDO 
Tolo 
DON: 
¡DEAD 


DO: 
oo 
rz cl 


Figure 1.100: OllyDbg: i = 1, is there that bit in the input value? No. (ZF =1) 


So, there is no corresponding bit in the input value. 


The piece of code, which increments the counter is not to be executed: the JZ in- 
struction bypassing it. 
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Let's trace a bit further and i is now 4. SHL is to be executed now: 


Ol 
ne SHORT ea29101F 
MOU EAX, cid PTR SS: [LOCAL. 1] 


EAX, 
DWORD PTR SS: [LOCAL.11,EAX 
E e 28 DWORD PTR SS:LtLOCRL.11,28 


SHORT 6029103F 
BA 61990000 EDX, 1 
8B4D FC ECX, DWORD PTR SS: LOCAL. 1] 


D3E2 — 
2355 88 AND EDX, DWORD PTR SS:CARG.1] 
74 09 E SHORT 90291850 


vey eee 
< 
SODIO 


« 


89291820 


3 m 


OODHANNDDO 
OOOHOO DA 


; B(FFFFFFFF) 
t BLFFFFFFFF) 
; B(FFFFFFFF) 
t BLFFFFFFFF) 
t TEFDDaBatFFF) 
> B(FFFFFFFF) 


EDX= 
Loop 88291816: loop variable CLOCAL.11](+1) 


EFL 


FFIFF FF 
FF 9i € RETURN from 


DO 


RETURN from 
ASCII ”pNo” 


TT 


Figure 1.101: OllyDbg: i—4, i is loaded into ECX 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


411 


EDX =1 «4 (or 0x10 or 16): 


CPU - main thread, module shifts 


83EC a8 SUB ESP,8 
C745 FS ogai MOU DWORD PTR SS: [LOCAL.2J,0 
C745 FC 60001 MOV DWORD PTR SS: [LOCAL.11,8 
ra SHORT 6929161F 
DU ERR, "ind PTR SS: [LOCAL. 1] 


DWORD PTR SS: LOCAL. 1], EAX 
837D FC 20 DWORD PTR SS:[LOCAL. 11,20 
70 1A SHORT 6029103F 
BA 91690000 
8B4D FC 


EDX, 1 
Ere DUURD PTR SS: [LOCAL. 1] 


cL 
EDX, DWORD PTR SS: [ARG. 1] 
Je SHORT 00291030 
8545 F8 Hou EAX, DWORD PTR SS: [LOCAL.2] 


Stack Tore EETA 
EDX=00000010 
Loop 00291016: loop variable LLOCRL.11(*1) 


€ 


ttt tt ng 


€ 


> 9929102F 


@(FFFFFFFF) 
@( FFFFFFFF) 
at FFFFFFFF) 
tFFFFFFFF) 
EFDDGBOLFFF) 
aC FFFFFFFF) 


M. 


SONO 5 


RETURN from shi 


RETURN from shi 
ASCII ”pNQ” 


Figure 1.102: OllyDbg: i= 4, EDX =1 « 4 = 0x10 


This is another bit mask. 
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AND is executed: 


CPU - main thread, module shifts Toxi 


C745 FS 60061 MOU DWORD PTR SS: [LOCAL.2],0 

MOV DWORD PTR SS: [LOCAL.11,8 

JMP SHORT 6029101F 

mou ER» DWORD PTR SS: [LOCAL. 11 
DWORD PTR SS: [LOCAL.1],EAX 

337D FC 28 DWORD PTR SS: [LOCAL.1],20 

7D 1A SHORT 06029103F 

BA 61998086 


EDX, 1 
ECX, DWORD PTR SS:CLOCAL. 1] 
EDX, CL 


EDX, DWORD PTR SS:[ARG. 11 a GLEEEEEEEE 

99291630 P 8 B FFEFFFFF) 

MOU EAX, DWORD PTR SS: CLOCAL.23 BLFFEFFEFE) 

8300 Bi ADD EAX, 1 DIEEEEERERÀ 
add a Mol > 


i z 7EFDDGGO( FFF) 
7 
D eeeeresD - jumps to shifts. 2 atFFFFFFFF) 
Loop 8682918016: loop variable CLOCAL.11](+ 


< 


veeyveene 


"i 


Co o Co 


FF FF|FF FF 
FF FF 01 RETURN from shi 


c me 


RETURN from shi 


ASCII "phó" 


bebas 


Figure 1.103: OllyDbg: i = 4, is there that bit in the input value? Yes. (ZF =0) 


ZF is O because this bit is present in the input value. 
Indeed, 0x12345678 & 0x10 - 0x10. 


This bit counts: the jump is not triggering and the bit counter incrementing. 
The function returns 13. This is total number of bits set in 0x12345678. 


GCC 


Let's compile it in GCC 4.4.1: 
Listing 1.293: GCC 4.4.1 


public f 
f proc near 
rt = dword ptr -0Ch 
i - dword ptr -8 
arg 0 - dword ptr 8 
push ebp 
mov ebp, esp 
push ebx 
sub esp, 10h 
mov [ebp+rt], 0 
mov [ebp+i], 0 
jmp short loc 80483EF 
loc 80483D0: 
mov eax, [ebp+i] 
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mov 
mov 
mov 
shl 
mov 
and 
test 
jz 
add 
loc 80483EB: 
add 
loc 80483EF: 
cmp 
jte 
mov 
add 
pop 
pop 
retn 
f endp 


edx, 1 

ebx, edx 

ecx, eax 

ebx, cl 

eax, ebx 

eax, [ebp«arg 0] 
eax, eax 

short loc 80483EB 
[ebp+rt], 1 


[ebpt+i], 1 


[ebp+i], 1Fh 
short loc 80483D0 
eax, [ebp+rt] 
esp, 10h 

ebx 

ebp 


x64 


Let’s modify the example slightly to extend it to 64-bit: 


#include <stdio.h> 
#include <stdint.h> 


#define IS SET(flag, bit) 


int f(uint64 t a) 

{ 
uint64 t i; 
int rt=0; 


for (i20; i«64; 


if (IS SET (a, 1ULL<<i)) 


rt++; 


return rt; 


F 


((flag) & (bit)) 


Non-optimizing GCC 4.8.2 


So far so easy. 


Listing 1.294: Non-optimizing GCC 4.8.2 


push rbp 
mov rbp, 
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mov QWORD PTR [rbp-24], rdi ; a 
mov DWORD PTR [rbp-12], 0 ; rt=0 
mov QWORD PTR [rbp-8], 0 ; i=0 
jmp .L2 
.L4: 
mov rax, QWORD PTR [rbp-8] 
mov rdx, QWORD PTR [rbp-24] 
; RAX = i, RDX =a 
mov ecx, eax 
; ECX =i 
shr rdx, cl 
; RDX = RDX>>CL = a>>i 
mov rax, rdx 
; RAX = RDX = a>>i 
and eax, 1 
; EAX = EAX&1 = (a>>i)&1 
test rax, rax 


; the last bit is zero? 
; Skip the next ADD instruction, if it was so. 


je .L3 
add DWORD PTR [rbp-12], 1 ; rte 
.L3: 
add QWORD PTR [rbp-8], 1 > ie 
.L2: 
cmp QWORD PTR [rbp-8], 63 ; i<63? 
jbe .L4 ; jump to the loop body begin, if so 
mov eax, DWORD PTR [rbp-12] ; return rt 
pop rbp 
ret 


Optimizing GCC 4.8.2 


Listing 1.295: Optimizing GCC 4.8.2 


f: 
xor eax, eax ; rt variable will be in EAX register 
xor ecx, ecx ; i variable will be in ECX register 
.L3: 
mov rsi, rdi ; load input value 
lea edx, [rax+1] ; EDX=EAX+1 


; EDX here is a new version of rt, 

; which will be written into rt variable, if the last bit is 1 
shr rsi, cl ; RSI=RSI>>CL 
and esi, 1 ; ESI-ESI&1 

; the last bit is 1? If so, write new version of rt into EAX 
cmovne eax, edx 


add rcx, 1 ; RCX++ 

cmp rcx, 64 

jne .L3 

rep ret ; AKA fatret 
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This code is terser, but has a quirk. 


In all examples that we see so far, we were incrementing the "rt" value after compar- 
ing a specific bit, but the code here increments "rt" before (line 6), writing the new 
value into register EDX. Thus, if the last bit is 1, the CMOVNE?^9 instruction (which is 
a synonym for CMOVNZi^/) commits the new value of "rt" by moving EDX ("proposed 
rt value") into EAX ("current rt" to be returned at the end). 


Hence, the incrementing is performed at each step of loop, i.e., 64 times, without 
any relation to the input value. 


The advantage of this code is that it contain only one conditional jump (at the end of 
the loop) instead of two jumps (skipping the "rt" value increment and at the end of 
loop). And that might work faster on the modern CPUs with branch predictors: 2.4.1 
on page 575. 


The last instruction is REP RET (opcode F3 C3) which is also called FATRET by MSVC. 
This is somewhat optimized version of RET, which is recommended by AMD to be 
placed at the end of function, if RET goes right after conditional jump: [Software 
Optimization Guide for AMD Family 16h Processors, (2013)p.15] 1^8. 


Optimizing MSVC 2010 


Listing 1.296: Optimizing MSVC 2010 


a$ = 8 
f PROC 
; RCX = input value 
xor eax, eax 
mov edx, 1 
lea r8d, QWORD PTR [rax+64] 
; R8D=64 
npad 5 
$LL4@f: 
test rdx, rcx 


; there are no such bit in input value? 
; skip the next INC instruction then. 


je SHORT $LN3@f 

inc eax ; rtee 
$LN3@f : 

rol rdx, 1 ; RDX=RDX<<1 

dec r8 ; R8-- 

jne SHORT $LL4@f 

fatret 0 
f ENDP 


Here the ROL instruction is used instead of SHL, which is in fact "rotate left" instead 
of "shift left", but in this example it works just as SHL. 


146 Conditional MOVe if Not Equal 
17 Conditional MOVe if Not Zero 
148 More information on it: http://repzret.org/p/repzret/ 
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You can read more about the rotate instruction here: .1.6 on page 1308. 
R8 here is counting from 64 to O. It's just like an inverted i. 
Here is a table of some registers during the execution: 


RDX R8 
0x0000000000000001 | 64 
0x0000000000000002 | 63 
0x0000000000000004 | 62 
0x0000000000000008 | 61 


0x4000000000000000 | 2 
0x8000000000000000 | 1 


At the end we see the FATRET instruction, which was explained here: 1.28.5 on the 
preceding page. 


Optimizing MSVC 2012 


Listing 1.297: Optimizing MSVC 2012 


a$ = 8 
f PROC 
; RCX = input value 
xor eax, eax 
mov edx, 1 
lea r8d, QWORD PTR [rax+32] 
; EDX = 1, R8D = 32 
npad 5 
$LL4@f : 
; pass 1l ------------------------------ 
test rdx, rcx 
je SHORT $LN3@f 
inc eax ; rt++ 
$LN3@f : 
rol rdx, 1 ; RDX=RDX<<1 
; pass 2 ------------------------------ 
test rdx, rcx 
je SHORT $LN11@f 
inc eax ; rt++ 
$LN11@f : 
rol rdx, 1 ; RDX=RDX<<1 
dec r8 ; R8-- 
jne SHORT $LL4@f 
fatret 0 
f ENDP 


Optimizing MSVC 2012 does almost the same job as optimizing MSVC 2010, but 
somehow, it generates two identical loop bodies and the loop count is now 32 instead 
of 64. 
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To be honest, it's not possible to say why. Some optimization trick? Maybe it's better 
for the loop body to be slightly longer? 


Anyway, such code is relevant here to show that sometimes the compiler output 
may be really weird and illogical, but perfectly working. 


ARM + Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


Listing 1.298: Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


MOV R1, RO 

MOV RO, #0 

MOV R2, #1 

MOV R3, RO 

loc 2b54 

TST R1, R2,LSL R3 ; set flags according to R1 & 
(R2««R3) 

ADD R3, R3, #1 ; R3++ 

ADDNE RO, RO, #1 ; if ZF flag is cleared by TST, 
then RO++ 

CMP R3, #32 

BNE loc 2bE54 

BX LR 


TST is the same thing as TEST in x86. 


As was noted before (3.12.3 on page 624), there are no separate shifting instructions 
in ARM mode. However, there are modifiers LSL (Logical Shift Left), LSR (Logical Shift 
Right), ASR (Arithmetic Shift Right), ROR (Rotate Right) and RRX (Rotate Right with 
Extend), which may be added to such instructions as MOV, TST, CMP, ADD, SUB, RSB!^?, 


These modificators define how to shift the second operand and by how many bits. 
Thus the “TST R1, R2,LSL R3" instruction works here as R1A(R2 « R3). 


ARM + Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


Almost the same, but here are two LSL . W/TST instructions are used instead of a single 
TST, because in Thumb mode it is not possible to define LSL modifier directly in TST. 


MOV R1, RO 
MOVS RO, #0 
MOV .W R9, #1 
MOVS R3, 40 

loc 2F7A 

LSL.W R2, R9, R3 
TST R2, R1 
ADD .W R3, R3, 41 
IT NE 
ADDNE RO, #1 
CMP R3, 432 
BNE loc 2F7A 
BX LR 


149These instructions are also called "data processing instructions" 
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ARM64 + Optimizing GCC 4.9 
Let's take the 64-bit example which has been already used: 1.28.5 on page 413. 
Listing 1.299: Optimizing GCC (Linaro) 4.8 


f: 
mov w2, 0 ; rt-0 
mov x5, 1 
mov wl, w2 
;L25 
Isl x4, x5, x1 ; w4 = w5<<wl = 1<<i 
add w3, w2, 1 ; new rt=rt+1 
tst x4, x0 ; (1««i) € a 
add wl, wl, 1 ; i++ 


; result of TST was non-zero? 
; then w2=w3 or rt=new rt. 
; otherwise: w2=w2 or rt=rt (idle operation) 


csel w2, w3, w2, ne 

cmp wl, 64 ; i«64? 

bne .L2 ; yes 

mov w0, w2 ; return rt 
ret 


The result is very similar to what GCC generates for x64: 1.295 on page 414. 


The CSEL instruction is "Conditional SELect". It just chooses one variable of two 
depending on the flags set by TST and copies the value into W2, which holds the "rt" 
variable. 


ARM64 + Non-optimizing GCC 4.9 


And again, we'll work on the 64-bit example which was already used: 1.28.5 on 
page 413. The code is more verbose, as usual. 


Listing 1.300: Non-optimizing GCC (Linaro) 4.8 


f: 
sub sp, sp, £32 
str x0, [sp,8] ; Store "a" value to Register Save Area 
str wzr, [sp,24] ; rt-0 
str wzr, [sp,28] ; i-0 
b .L2 
.L4: 
ldr w0, [sp,28] 
mov x1, 1 
Isl x0, x1, x0 ; X0 = Xl<<X0 = l<<i 
mov x1, x0 
; XI = l<<i 
ldr x0, [sp,8] 
; X0 =a 
and x0, x1, x0 


; XO = X16X0 = (1<<i) € a 
; XO contain zero? then jump to .L3, skipping "rt" increment 
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cmp x0, xzr 
beq .L3 
> rte 
ldr w0, [sp,24] 
add w0, w0, 1 
str w0, [sp,24] 
.L3: 
; lt 
ldr w0, [sp,28] 
add w0, w0, 1 
str w0, [sp,28] 
.L2: 


; 1<=63? then jump to .L4 
ldr w0, [sp,28] 
cmp w0, 63 


ble .L4 

; return rt 
ldr w0, [sp,24] 
add sp, sp, 32 
ret 


MIPS 
Non-optimizing GCC 


Listing 1.301: Non-optimizing GCC 4.4.5 (IDA) 


f: 
; IDA is not aware of variable names, we gave them manually: 
rt = -0x10 
i = -0xC 
var 4 = -4 
a = 0 
addiu $sp, -0x18 
SW $fp, Ox18+var_4($sp) 
move $fp, $sp 
Sw $a0, Ox18+a($fp) 
; initialize rt and i variables to zero: 
SW $zero, 0x18+rt($fp) 
SW $zero, 0x18+i($fp) 
; jump to loop check instructions: 
b loc 68 
or $at, $zero ; branch delay slot, NOP 
loc 20: 
li $v1, 1 
lw $v0, 0x18+i($fp) 
or $at, $zero ; load delay slot, NOP 
sllv $v0, $vl, $v0 
; $vO = l<<i 


move $vl, $v0 
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lw $v0, Ox18+a($fp) 
or gat, $zero ; load delay slot, NOP 
and $v0, $vl, $v0 


; $v0 =a € (1««i) 
; is a & (1««i) equals to zero? jump to loc 58 then: 
begz $v0, loc 58 


or $at, $zero 

; no jump occurred, that means a € (1««i)!-0, so increment "rt" then: 
lw $v0, 0x18+rt($fp) 
or $at, $zero ; load delay slot, NOP 
addiu $v0, 1 
SW $v0, 0x18+rt($fp) 

loc 58: 

; increment i: 
lw $v0, 0x18+i($fp) 
or $at, $zero ; load delay slot, NOP 
addiu $v0, 1 
SW $v0, 0x18+i($fp) 


loc 68: 
; load i and compare it with 0x20 (32). 
; jump to loc 20 if it is less then 0x20 (32): 
lw $v0, 0x18+i($fp) 
or $at, $zero ; load delay slot, NOP 
slti $v0, 0x20 #' ' 
bnez $v0, loc 20 


or $at, $zero ; branch delay slot, NOP 
; function epilogue. return rt: 

lw $v0, 0x18+rt($fp) 

move $sp, $fp ; load delay slot 

lw $fp, Ox18+var_4($sp) 

addiu $sp, 0x18 ; load delay slot 

jr $ra 

or $at, $zero ; branch delay slot, NOP 


That is verbose: all local variables are located in the local stack and reloaded each 
time they're needed. 


The SLLV instruction is “Shift Word Left Logical Variable”, it differs from SLL only in 
that the shift amount is encoded in the SLL instruction (and is fixed, as a conse- 
quence), but SLLV takes shift amount from a register. 


Optimizing GCC 


That is terser. There are two shift instructions instead of one. Why? 


It's possible to replace the first SLLV instruction with an unconditional branch instruc- 
tion that jumps right to the second SLLV. But this is another branching instruction in 
the function, and it's always favorable to get rid of them: 2.4.1 on page 575. 


Listing 1.302: Optimizing GCC 4.4.5 (IDA) 
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f: 

; $a0=a 

; rt variable will reside in $v0: 
move $v0, $zero 

; i variable will reside in $vl: 
move $v1, $zero 
li $t0, 1 
li $a3, 32 


sllv $al, $tO, $v1 
; $al = $t0<<$vl = l<<i 


loc 14: 
and $al, $a0 
; $al = a&(1««i) 
; increment i: 
addiu $v1, 1 
; jump to loc 28 if a&(1««i)--0 and increment rt: 
begz $al, loc 28 
addiu $a2, $v0, 1 
; if BEQZ was not triggered, save updated rt into $v0: 


move $v0, $a2 
loc 28: 
; if i!=32, jump to loc 14 and also prepare next shifted value: 
bne $v1, $a3, loc 14 
sllv $al, $t0, $vl 
; return 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


1.28.6 Conclusion 


Analogous to the C/C++ shifting operators « and >, the shift instructions in x86 are 
SHR/SHL (for unsigned values) and SAR/SHL (for signed values). 


The shift instructions in ARM are LSR/LSL (for unsigned values) and ASR/LSL (for 
signed values). 


It’s also possible to add shift suffix to some instructions (which are called "data 
processing instructions"). 
Check for specific bit (known at compile stage) 
Test if the 061000000 bit (0x40) is present in the register’s value: 
Listing 1.303: C/C++ 


if (input&0x40) 


Listing 1.304: x86 


TEST REG, 40h 
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JNZ is set 
; bit is not set 


Listing 1.305: x86 


TEST REG, 40h 
JZ is cleared 
; bit is set 


Listing 1.306: ARM (ARM mode) 


TST REG, #0x40 
BNE is set 
; bit is not set 


Sometimes, AND is used instead of TEST, but the flags that are set are the same. 


Check for specific bit (specified at runtime) 


This is usually done by this C/C++ code snippet (shift value by n bits right, then cut 
off lowest bit): 


Listing 1.307: C/C++ 


if ((value>>n)&1) 


This is usually implemented in x86 code as: 


Listing 1.308: x86 


; REG=input value 
» CESA 

SHR REG, CL 

AND REG, 1 


Or (shift 1 bit n times left, isolate this bit in input value and check if it's not zero): 


Listing 1.309: C/C++ 


if (value & (1««n)) 


This is usually implemented in x86 code as: 


Listing 1.310: x86 


; CL=n 

MOV REG, 1 

SHL REG, CL 

AND input value, REG 
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Set specific bit (known at compile stage) 


Listing 1.311: C/C++ 


value=vaLlue| 0x40; 


Listing 1.312: x86 


OR REG, 40h 


Listing 1.313: ARM (ARM mode) and ARM64 


ORR RO, RO, #0x40 


Set specific bit (specified at runtime) 


Listing 1.314: C/C++ 


value=value | (1<<n) ; 


This is usually implemented in x86 code as: 


Listing 1.315: x86 


= CLES 

MOV REG, 1 

SHL REG, CL 

OR input value, REG 


Clear specific bit (known at compile stage) 
Just apply AND operation with the inverted value: 


Listing 1.316: C/C++ 


va lue=value&(~0x40) ; 


Listing 1.317: x86 


AND REG, OFFFFFFBFh 


Listing 1.318: x64 


AND REG, OFFFFFFFFFFFFFFBFh 


This is actually leaving all bits set except one. 


ARM in ARM mode has BIC instruction, which works like the NOT +AND instruction 
pair: 


Listing 1.319: ARM (ARM mode) 


BIC RO, RO, #0x40 
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Clear specific bit (specified at runtime) 


Listing 1.320: C/C++ 


value-value&(-(1««n)); 


Listing 1.321: x86 


; CL=n 

MOV REG, 1 
SHL REG, CL 
NOT REG 


AND input value, REG 


1.28.7 Exercises 
* http://challenges.re/67 
* http://challenges.re/68 
* http://challenges.re/69 
* http://challenges.re/70 


1.29 Linear congruential generator as pseudoran- 
dom number generator 

Perhaps, the linear congruential generator is the simplest possible way to generate 

random numbers. 


It's not in favour nowadays???, but it’s so simple (just one multiplication, one addition 
and AND operation), that we can use it as an example. 


#include <stdint.h> 

// constants from the Numerical Recipes book 
#define RNG_a 1664525 

#define RNG c 1013904223 


static uint32 t rand state; 


void my srand (uint32 t init) 


{ 
I 


rand state-init; 


int my rand () 
1 
rand_state=rand_state*RNG_a; 
rand_state=rand_state+RNG_c; 


150Mersenne twister is better 
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return rand state & Ox7fff; 


There are two functions: the first one is used to initialize the internal state, and the 
second one is called to generate pseudorandom numbers. 


We see that two constants are used in the algorithm. They are taken from [William H. 
Press and Saul A. Teukolsky and William T. Vetterling and Brian P. Flannery, Numerical 
Recipes, (2007)]. 


Let's define them using a #define C/C++ statement. It's a macro. 


The difference between a C/C++ macro and a constant is that all macros are replaced 
with their value by C/C++ preprocessor, and they don't take any memory, unlike 
variables. 


In contrast, a constant is a read-only variable. 


It’s possible to take a pointer (or address) of a constant variable, but impossible to 
do so with a macro. 


The last AND operation is needed because by C-standard my rand() has to return a 
value in the 0..32767 range. 


If you want to get 32-bit pseudorandom values, just omit the last AND operation. 


1.29.1 x86 


Listing 1.322: Optimizing MSVC 2013 


_BSS SEGMENT 
rand state DD 01H DUP (?) 


_BSS ENDS 

_init$ = 8 

_srand PROC 
mov eax, DWORD PTR _init$[esp-4] 
mov DWORD PTR _rand_state, eax 
ret 0 

_srand ENDP 

_ TEXT SEGMENT 

rand PROC 
imul eax, DWORD PTR rand state, 1664525 
add eax, 1013904223 ; 3c6ef35fH 
mov DWORD PTR rand state, eax 
and eax, 32767 ; 00007fffH 
ret 0 

rand  ENDP 

_ TEXT ENDS 


Here we see it: both constants are embedded into the code. There is no memory 
allocated for them. 
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The my srand() function just copies its input value into the internal 
rand state variable. 


my rand() takes it, calculates the next rand state, cuts it and leaves it in the EAX 
register. 


The non-optimized version is more verbose: 


Listing 1.323: Non-optimizing MSVC 2013 


_BSS SEGMENT 
rand state DD 01H DUP (?) 


_BSS ENDS 

_init$ = 8 

 srand PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR _init$[ebp] 
mov DWORD PTR rand state, eax 
pop ebp 
ret 0 

 srand ENDP 

TEXT | SEGMENT 

rand PROC 
push ebp 
mov ebp, esp 
imul eax, DWORD PTR rand state, 1664525 
mov DWORD PTR rand state, eax 
mov ecx, DWORD PTR rand state 
add ecx, 1013904223 ; 3c6ef35fH 
mov DWORD PTR rand state, ecx 
mov eax, DWORD PTR rand state 
and eax, 32767 ; 00007fffH 
pop ebp 
ret 0 

rand  ENDP 

TEXT X ENDS 

1.29.2 x64 


The x64 version is mostly the same and uses 32-bit registers instead of 64-bit ones 
(because we are working with int values here). 


But my srand() takes its input argument from the ECX register rather than from 
stack: 


Listing 1.324: Optimizing MSVC 2013 x64 


_BSS SEGMENT 
rand state DD 01H DUP (?) 
_BSS ENDS 
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init$ = 8 
my srand PROC 


; ECX = input argument 
DWORD PTR rand state, ecx 


mov 
ret 
my srand ENDP 


TEXT | SEGMENT 
my rand PROC 
imul 
add 
mov 
and 
ret 
my rand ENDP 


TEXT ENDS 


0 


eax, DWORD PTR rand state, 1664525 ; 0019660dH 


eax, 1013904223 ; 3c6ef35fH 
DWORD PTR rand state, eax 
eax, 32767 ; 00007fffH 
0 


GCC compiler generates mostly the same code. 


1.29.3 32-bit ARM 


Listing 1.325: Optimizing Keil 6/2013 (ARM mode) 
my srand PROC 
LDR r1,|L0.52| ; load pointer to rand state 
STR ro,[r1,20] ; save rand state 
BX lr 
ENDP 
my rand PROC 
LDR r0,|L0.52| ; load pointer to rand state 
LDR r2,|L0.56| ; load RNG a 
LDR rl,[r0,20] ; load rand state 
MUL rl,r2,r1 
LDR r2,|L0.60| ; load RNG c 
ADD rl,rl,r2 
STR rl,[r0,20] ; save rand state 
; AND with Ox7FFF: 
LSL r0,r1,417 
LSR r0,r0,#17 
BX lr 
ENDP 
[L0.52| 
DCD || .data| | 
[L0.56| 
DCD 0x0019660d 
[L0.60| 
DCD 0x3c6ef35f 


AREA ||.data||, DATA, ALIGN-2 
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rand state 
DCD 0x00000000 


It’s not possible to embed 32-bit constants into ARM instructions, so Keil has to 
place them externally and load them additionally. One interesting thing is that it's 
not possible to embed the Ox7FFF constant as well. So what Keil does is shifting 
rand state left by 17 bits and then shifting it right by 17 bits. This is analogous to 
the (rand. state « 17) > 17 statement in C/C++. It seems to be useless operation, but 
what it does is clearing the high 17 bits, leaving the low 15 bits intact, and that's our 
goal after all. 


Optimizing Keil for Thumb mode generates mostly the same code. 


1.29.4 MIPS 
Listing 1.326: Optimizing GCC 4.4.5 (IDA) 


my srand: 
; store $a0 to rand state: 
lui $v0, (rand state >> 16) 
jr $ra 
SW $a0, rand_state 
my_rand: 
; load rand state to $v0: 
lui $v1, (rand state >> 16) 
lw $v0, rand state 
or gat, $zero ; load delay slot 
; multiplicate rand state in $v0 by 1664525 (RNG a): 
sll $al, $v0, 2 
sll $a0, $v0, 4 
addu $a0, $al, $a0 
sll $al, $a0, 6 


subu $a0, $al, $a0 
addu $a0, $v0 
sll $al, $a0, 5 
addu $a0, $al 
sll $a0, 3 
addu $v0, $a0, $v0 
sll $a0, $v0, 2 
addu $v0, $a0 
; add 1013904223 (RNG C) 
; the LI instruction is coalesced by IDA from LUI and ORI 
li $a0, Ox3C6EF35F 
addu $v0, $a0 
; store to rand state: 
SW $v0, (rand state € OxFFFF)($v1) 
jr $ra 
andi $v0, Ox7FFF ; branch delay slot 


Wow, here we see only one constant (0x3C6EF35F or 1013904223). Where is the 
other one (1664525)? 
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It seems that multiplication by 1664525 is performed by just using shifts and addi- 
tions! Let's check this assumption: 


define RNG a 1664525 


int f (int a) 


1 
return a*RNG a; 
} 
Listing 1.327: Optimizing GCC 4.4.5 (IDA) 

f: 

sll $v1, $a0, 2 

sll $v0, $a0, 4 

addu $v0, $vl, $v0 

sll $v1, $v0, 6 

subu $v0, $v1, $v0 

addu $v0, $a0 

sll $v1, $v0, 5 

addu $v0, $v1 

sll $v0, 3 

addu $a0, $v0, $a0 

sll $v0, $a0, 2 

jr $ra 

addu $v0, $a0, $v0 ; branch delay slot 
Indeed! 


MIPS relocations 


We will also focus on how such operations as load from memory and store to memory 
actually work. 


The listings here are produced by IDA, which hides some details. 
We'll run objdump twice: to get a disassembled listing and also relocations list: 


Listing 1.328: Optimizing GCC 4.4.5 (objdump) 


# objdump -D rand 03.0 


00000000 «my srand»: 


0: 3c020000 lui v0,0x0 

4: 03e00008 jr ra 

8: ac440000 SW a0,0(v0) 

0000000c «my rand»: 

C: 3c030000 lui v1,0x0 
10: 8c620000 lw v0,0(v1) 
14: 00200825 move at,at 
18: 00022880 sll al,v0,0x2 
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1c: 00022100 sll a0,v0,0x4 
20: 00342021 addu a0,al,a0 

24: 00042980 sll al,a0,0x6 
28: 00a42023 subu a0,a1,a0 

2c: 00822021 addu a0,a0,v0 

30: 00042940 sll al,a0,0x5 
34: 00852021 addu a0,a0,al 

38: 000420c0 sll a0,a0,0x3 
3c: 00821021 addu v0,a0,v0 

40: 00022080 sll a0,v0,0x2 
44: 00441021 addu v0, v0,a0 

48: 3c043c6e lui a0,0x3c6e 
4C: 3484f35f ori a0,a0,0xf35f 
50: 00441021 addu v0,v0,a0 

54: ac620000 SW v0,0(v1) 

58: 03e00008 jr ra 

5c: 30427fff andi v0,v0,0x7fff 


# objdump -r rand 03.0 


RELOCATION RECORDS FOR [.text]: 


OFFSET TYPE VALUE 
00000000 R MIPS HI16 .bss 
00000008 R MIPS L016 „bss 
0000000c R MIPS HI16 „bss 
00000010 R MIPS L016 .bss 
00000054 R MIPS L016 .bss 


Let's consider the two relocations for the my srand() function. 


The first one, for address O has a type of R MIPS HI16 and the second one for address 
8 has a type of R MIPS L016. 


That implies that address of the beginning of the .bss segment is to be written into 
the instructions at address of O (high part of address) and 8 (low part of address). 


The rand state variable is at the very start of the .bss segment. 


So we see zeros in the operands of instructions LUI and SW, because nothing is there 
yet— the compiler don't know what to write there. 


The linker will fix this, and the high part of the address will be written into the operand 
of LUI and the low part of the address—to the operand of SW. 


SW will sum up the low part of the address and what is in register $VO (the high part 
is there). 


It’s the same story with the my rand() function: R MIPS HI16 relocation instructs 
the linker to write the high part of the .bss segment address into instruction LUI. 
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So the high part of the rand state variable address is residing in register $V1. 


The LW instruction at address Ox10 sums up the high and low parts and loads the 
value of the rand state variable into $VO. 


The SW instruction at address 0x54 do the summing again and then stores the new 
value to the rand state global variable. 


IDA processes relocations while loading, thus hiding these details, but we should 
keep them in mind. 
1.29.5 Thread-safe version of the example 


The thread-safe version ofthe example is to be demonstrated later: 6.2.1 on page 944. 


1.30 Structures 


A C/C++ structure, with some assumptions, is just a set of variables, always stored 
in memory together, not necessary of the same type 1°t, 
1.30.1 MSVC: SYSTEMTIME example 


Let's take the SYSTEMTIME??? win32 structure that describes time. 
This is how it's defined: 


Listing 1.329: WinBase.h 


typedef struct SYSTEMTIME { 
WORD wYear; 
WORD wMonth; 
WORD wDayOfWeek; 
WORD wDay; 
WORD wHour; 
WORD wMinute; 
WORD wSecond; 
WORD wMilliseconds; 
) SYSTEMTIME, *PSYSTEMTIME; 


Let's write a C function to get the current time: 


#include «windows.h» 
#include <stdio.h> 


void main() 


SYSTEMTIME t; 
GetSystemTime (&t); 


151AKA "heterogeneous container” 
152MSDN: SYSTEMTIME structure 
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printf ("%04d-%02d-%02d %02d:%02d:%02d\n", 
t.wYear, t.wMonth, t.wDay, 
t.wHour, t.wMinute, t.wSecond) ; 


return; 


yi 


We get (MSVC 2010): 
Listing 1.330: MSVC 2010 /GS- 


_t$ = -16 ; size = 16 


_main PROC 
push ebp 
mov ebp, esp 


sub esp, 16 

lea eax, DWORD PTR _t$[ebp] 

push eax 

call DWORD PTR imp GetSystemTime@4 
movzx ecx, WORD PTR t$[ebp+12] ; wSecond 


push ecx 

movzx edx, WORD PTR t$[ebp+10] ; wMinute 
push edx 

movzx eax, WORD PTR t$[ebp+8] ; wHour 
push eax 

movzx ecx, WORD PTR t$[ebp+6] ; wDay 
push ecx 

movzx edx, WORD PTR t$[ebp+2] ; wMonth 
push edx 

movzx eax, WORD PTR t$[ebp] ; wYear 
push eax 


push OFFSET $SG78811 ; '%04d-%02d-%02d %02d:%02d:%02d', OaH, OOH 
call printf 
add esp, 28 


xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 

main ENDP 


16 bytes are allocated for this structure in the local stack —that is exactly sizeof (WORD) *8 
(there are 8 WORD variables in the structure). 


Pay attention to the fact that the structure begins with the wYear field. It can be said 
that a pointer to the SYSTEMTIME structure is passed to the GetSystemTime()!??, 
but it is also can be said that a pointer to the wYear field is passed, and that is the 
same! GetSystemTime() writes the current year to the WORD pointer pointing to, 
then shifts 2 bytes ahead, writes current month, etc., etc. 


153MSDN: SYSTEMTIME structure 
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OllyDbg 
Let's compile this example in MSVC 2010 with /GS- /MD keys and run it in OllyDbg. 


Let's open windows for data and stack at the address which is passed as the first 
argument of the GetSystemTime() function, and let's wait until it’s executed. We 
see this: 


CPU - main thread, module Mi 


Registers (FPU) 
Ti 
CLOCAL. 41 


: DS: [<&KERNELS2, GetSystem 
PTR SS: LOCAL. 11 


MNA SI BB 
: LLOCRL. 2+2] n 00993398 systemt ime. 0099: ; 
WORD PTR SS: [LOCAL.2] : ^ 00991010 systemt ime. 0991014 
WORD P : LOCAL. 3+2] 1 aaa 


EDX, WORD PTR SS: [LOCAL.4+21 pd 


a : z 3 VEFODGGG( FFF) 
Stack [OB2EFB60]=0034 d 
ECX=000003D4 (decimal 988.) p.» ved O(FFFFFFFF) 


tErr 86000800 ERROR SUCCESS 
E,BE,NS,PE,GE,LE) n 


DE a7 ac Be 02 do 09 0G 16 68 10 69 34 08 D4 O3 d. 2; | BEUDE "ehem s 
EET Lr. nil B 


Figure 1.104: OllyDbg: GetSystemTime() just executed 


The system time of the function execution on my computer is 9 December 2014, 
22:29:52: 


Listing 1.331: printf() output 


2014-12-09 22:29:52 


So we see these 16 bytes in the data window: 


DE 07 OC 00 02 00 09 00 16 00 1D 00 34 00 D4 03 


Each two bytes represent one field of the structure. Since the endianness is little 
endian, we see the low byte first and then the high one. 


Hence, these are the values currently stored in memory: 
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Hexadecimal number | decimal number | field name 
0x07DE 2014 wYear 
0x000C 12 wMonth 
0x0002 2 wDayOfWeek 
0x0009 9 wDay 
0x0016 22 wHour 
0x001D 29 wMinute 
0x0034 52 wSecond 
0x03D4 980 wMilliseconds 


The same values are seen in the stack window, but they are grouped as 32-bit values. 
And then printf() just takes the values it needs and outputs them to the console. 


Some values aren't output by printf () (wDayOfWeek and wMilliseconds), but they 
are in memory right now, available for use. 


Replacing the structure with array 


The fact that the structure fields are just variables located side-by-side, can be easily 
demonstrated by doing the following. Keeping in mind the SYSTEMTIME structure 
description, it's possible to rewrite this simple example like this: 


#include «windows.h» 
#include <stdio.h> 


void main() 


{ 
WORD array[8]; 
GetSystemTime (array); 
printf ("%04d-%02d-%02d %02d:%02d:%02d\n", 
array[0] /* wYear */, array[1] /* wMonth */, array[3] /* wDay */, 
array[4] /* wHour */, array[5] /* wMinute */, array[6] /* wSecond ^» 
S */); 
return; 
}; 


The compiler grumbles a bit: 


systemtime2.c(7) : warning C4133: 'function' : incompatible types - from ' 2 
S WORD [8]' to 'LPSYSTEMTIME ' 


But nevertheless, it produces this code: 


Listing 1.332: Non-optimizing MSVC 2010 


$5G78573 DB 'S04d-%02d-%02d %02d:%02d:%02d', OaH, OOH 
_array$ = -16 ; size = 16 
main PROC 

push ebp 
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mov ebp, esp 

sub esp, 16 

lea eax, DWORD PTR array$[ebp] 
push eax 


call DWORD PTR imp GetSystemTime@4 
movzx ecx, WORD PTR _array$[ebp+12] ; wSecond 


push ecx 
movzx edx, WORD PTR array$[ebp+10] ; wMinute 
push edx 
movzx eax, WORD PTR _array$[ebp+8] ; wHoure 
push eax 
movzx ecx, WORD PTR array$[ebp+6] ; wDay 
push ecx 
movzx edx, WORD PTR _array$[ebp+2] ; wMonth 
push edx 
movzx eax, WORD PTR array$[ebp] ; wYear 
push eax 
push OFFSET $5G78573 ; '%04d-%02d-%02d %02d:%02d:%02d', OaH, OOH 
call _ printf 
add esp, 28 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 
main  ENDP 


And it works just as the same! 


It is very interesting that the result in assembly form cannot be distinguished from 
the result of the previous compilation. 


So by looking at this code, one cannot say for sure if there was a structure declared, 
or an array. 


Nevertheless, no sane person would do it, as it is not convenient. 
Also the structure fields may be changed by developers, swapped, etc. 


We will not study this example in OllyDbg, because it will be just the same as in the 
case with the structure. 


1.30.2 Let's allocate space for a structure using malloc() 


Sometimes it is simpler to place structures not in the local stack, but in the heap: 


#include «windows.h» 
#include <stdio.h> 


void main() 
SYSTEMTIME *t; 


t=(SYSTEMTIME *)malloc (sizeof (SYSTEMTIME) ); 
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GetSystemTime (t); 

printf ("%04d-%02d-%02d %02d:%02d:%02d\n", 
t->wYear, t->wMonth, t->wDay, 
t->wHour, t->wMinute, t->wSecond); 


free (t); 


return; 


3 


Let’s compile it now with optimization (/0x) so it would be easy to see what we need. 


Listing 1.333: Optimizing MSVC 


main PROC 
push esi 
push 16 
call malloc 
add esp, 4 
mov esi, eax 
push esi 


call DWORD PTR imp GetSystemTime@4 
movzx eax, WORD PTR [esi+12] ; wSecond 


movzx ecx, WORD PTR [esi+10] ; wMinute 
movzx edx, WORD PTR [esi+8] ; wHour 
push eax 

movzx eax, WORD PTR [esi+6] ; wDay 
push ecx 

movzx ecx, WORD PTR [esi+2] ; wMonth 
push edx 

movzx edx, WORD PTR [esi] ; wYear 
push eax 

push ecx 

push edx 


push OFFSET $5G78833 
call printf 


push esi 
call | free 
add esp, 32 
xor eax, eax 
pop esi 
ret 0 

main ENDP 


So, sizeof (SYSTEMTIME) = 16 and that is exact number of bytes to be allocated by 
malloc(). It returns a pointer to a freshly allocated memory block in the EAX register, 
which is then moved into the ESI register. GetSystemTime() win32 function takes 
care of saving value in ESI, and that is why it is not saved here and continues to be 
used after the GetSystemTime() call. 


New instruction —MOVZX (Move with Zero eXtend). It may be used in most cases 
as MOVSX, but it sets the remaining bits to O. That's because printf() requires a 
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32-bit int, but we got a WORD in the structure —that is 16-bit unsigned type. That's 
why by copying the value from a WORD into int, bits from 16 to 31 must be cleared, 
because a random noise may be there, which is left from the previous operations on 
the register(s). 


In this example, it's possible to represent the structure as an array of 8 WORDs: 


#include «windows.h» 
#include <stdio.h> 


void main() 


{ 
WORD *t; 
t=(WORD *)malloc (16); 
GetSystemTime (t); 
printf ("%04d-%02d-%02d %02d:%02d:%02d1n", 
t[0] /* wYear */, t[1] /* wMonth */, t[3] /* wDay */, 
t[4] /* wHour */, t[5] /* wMinute */, t[6] /* wSecond */); 
free (t); 
return; 
ur 
We get: 

Listing 1.334: Optimizing MSVC 
$5G78594 DB 'S04d-%02d-%02d %02d:%02d:%02d', OaH, OOH 
main PROC 

push esi 

push 16 

call  malloc 
add esp, 4 
mov esi, eax 
push esi 


call DWORD PTR imp  GetSystemTime@4 
movzx eax, WORD PTR [esi+12] 

movzx ecx, WORD PTR [esi+10] 

movzx edx, WORD PTR [esi+8] 


push eax 

movzx eax, WORD PTR [esi+6] 
push ecx 

movzx ecx, WORD PTR [esi+2] 
push edx 

movzx edx, WORD PTR [esi] 
push eax 

push ecx 

push edx 


push OFFSET $5G78594 
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call | printf 
push esi 
call free 
add esp, 32 
xor eax, eax 
pop esi 
ret 0 

main  ENDP 


Again, we got the code that cannot be distinguished from the previous one. 


And again it has to be noted, you haven't to do this in practice, unless you really 
know what you are doing. 

1.30.3 UNIX: struct tm 

Linux 


Let's take the tm structure from time.h in Linux for example: 


#include <stdio.h> 
#include <time.h> 


void main() 


{ 
struct tm t; 
time t unix time; 
unix time-time (NULL); 
localtime r (&unix time, &t); 
printf ("Year: %d\n", t.tm_year+1900) ; 
printf ("Month: %d\n", t.tm mon); 
printf ("Day: %d\n", t.tm mday); 
printf ("Hour: %d\n", t.tm hour); 
printf ("Minutes: %d\n", t.tm min); 
printf ("Seconds: %d\n", t.tm sec); 
$; 


Let's compile it in GCC 4.4.1: 
Listing 1.335: GCC 4.4.1 


main proc near 


push ebp 

mov ebp, esp 

and esp, OFFFFFFFOh 

sub esp, 40h 

mov dword ptr [esp], 0 ; first argument for time() 

call time 

mov [esp+3Ch], eax 

lea eax, [esp+3Ch] ; take pointer to what time() returned 
lea edx, [esp-10h] ; at ESP+10h struct tm will begin 
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mov 
mov 
call 
mov 
lea 
mov 
mov 
mov 
call 
mov 
mov 
mov 
mov 
call 
mov 
mov 
mov 
mov 
call 
mov 
mov 
mov 
mov 
call 
mov 
mov 
mov 
mov 
call 
mov 
mov 
mov 
mov 
call 
leave 
retn 

main endp 


[esp+4], edx ; pas 
[esp], eax ; pas 
localtime r 

eax, [esp+24h] ; tm 
edx, [eax+76Ch] ; edx 
eax, offset format ; 
[esp+4], edx 

[esp], eax 

printf 

edx, [esp+20h] : 
eax, offset aMonthD ; 
[esp+4], edx 

[esp], eax 

printf 

edx, [esp+1Ch] : 
eax, offset aDayD ; 
[esp+4], edx 

[esp], eax 

printf 

edx, [esp+18h] ; 
eax, offset aHourD ; 
[esp+4], edx 

[esp], eax 

printf 

edx, [esp+14h] 

eax, offset aMinutesD 
[esp+4], edx 

[esp], eax 

printf 

edx, [esp+10h] 

eax, offset aSecondsD 
[esp+4], edx 

[esp], eax 

printf 


s pointer to the structure begin 
s pointer to result of time() 


year 
=eax+1900 
"Year: %d\n" 


tm mon 
"Month: %d\n" 


tm mday 
"Day: %d\n" 


tm hour 
"Hour: %d\n" 


; tm min 
; "Minutes: %d\n" 
; "Seconds: %d\n" 
; tm sec 


Somehow, IDA did not write the local variables' names in the local stack. But since we 
already are experienced reverse engineers :-) we may do it without this information 
in this simple example. 


Please also pay attention to the lea edx, 


[eax+76Ch] —this instruction just adds 


0x76C (1900) to value in EAX, but doesn't modify any flags. See also the relevant 
section about LEA (.1.6 on page 1299). 


GDB 


Let's try to load the example into GDB 154: 


154The date result is slightly corrected for demonstration purposes. Of course, it's not possible to run 
GDB that quickly, in the same second. 
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Listing 1.336: GDB 


dennis@ubuntuvm:~/polygon$ date 

Mon Jun 2 18:10:37 EEST 2014 
dennis@ubuntuvm:~/polygon$ gcc GCC tm.c -o GCC tm 
dennis@ubuntuvm:~/polygon$ gdb GCC tm 

GNU gdb (GDB) 7.6.1-ubuntu 


Reading symbols from /home/dennis/polygon/GCC tm...(no debugging symbols 7 
y found)...done. 

(gdb) b printf 

Breakpoint 1 at 0x8048330 

(gdb) run 

Starting program: /home/dennis/polygon/GCC tm 


Breakpoint 1, _ printf (format=0x80485c0 "Year: %d\n") at printf.c:29 
29 printf.c: No such file or directory. 
(gdb) x/20x $esp 


OxbffffOdc: 0x080484c3 0x080485c0 0x000007de 0x00000000 
OxbffffOec: 0x08048301 0x538c93ed 0x00000025 0x0000000a 
OxbffffOfc: 0x00000012 0x00000002 0x00000005 0x00000072 
Oxbffffl0c: 0x00000001 0x00000098 0x00000001 0x00002a30 
Oxbffffllc: 0x0804b090 0x08048530 0x00000000 0x00000000 
(gdb) 


We can easily find our structure in the stack. First, let's see how it's defined in time.h: 


Listing 1.337: time.h 


struct tm 

1 
int tm sec; 
int tm min; 
int tm hour; 
int — tm mday; 
int tm mon; 
int tm year; 
int tm wday; 
int tm yday; 
int tm isdst; 

yi 


Pay attention that 32-bit int is used here instead of WORD in SYSTEMTIME. So, each 
field occupies 32-bit. 


Here are the fields of our structure in the stack: 


OxbffffOdc: 0x080484c3 0x080485c0 0x000007de 

OxbffffOec: 0x08048301 0x538c93ed 0x00000025 sec 

OxbffffOfc: 0x00000012 hour 0x00000002 mday 0x00000005 mon 
y year 

OxbfffflOc: 0x00000001 wday 0x00000098 yday 0x00000001 isdst 0x00002a30 

Oxbffffllc: 0x0804b090 0x08048530 0x00000000 0x00000000 


0x00000000 
0x0000000a min 
0x00000072 7 


Or as a table: 
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Hexadecimal number | decimal number | field name 
0x00000025 37 tm sec 
0x0000000a 10 tm min 
0x00000012 18 tm hour 
0x00000002 2 tm mday 
0x00000005 5 tm mon 
0x00000072 114 tm year 
0x00000001 1 tm_wday 
0x00000098 152 tm_yday 
0x00000001 1 tm_isdst 


Just like SYSTEMTIME (1.30.1 on page 431), 


there are also other fields available that are not used, like tm_wday, tm_yday, tm_isdst. 
ARM 
Optimizing Keil 6/2013 (Thumb mode) 


Same example: 


Listing 1.338: Optimizing Keil 6/2013 (Thumb mode) 


var 38 = -0x38 
var 34 = -0x34 
var 30 - -0x30 
var 2C = -0x2C 
var 28 - -0x28 
var 24 = -0x24 
timer = -0xC 
PUSH (LR) 
MOVS RO, £0 ; timer 
SUB SP, SP, 40x34 
BL time 
STR RO, [SP,#0x38+timer] 
MOV R1, SP ; tp 
ADD RO, SP, #0x38+timer ; timer 
BL localtime r 
LDR R1, =0x76C 
LDR RO, [SP,#0x38+var_ 24] 
ADDS R1, RO, R1 
ADR RO, aYearD ; "Year: %d\n" 
BL . 2printf 
LDR R1, [SP,#0x38+var_ 28] 
ADR RO, aMonthD ; "Month: %d\n" 
BL _ 2printf 
LDR R1, [SP,*0x38+var_2C] 
ADR RO, aDayD ; "Day: %d\n" 
BL . 2printf 
LDR R1, [SP,#0x38+var_30] 
ADR RO, aHourD "Hour: %d\n" 
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BL . 2printf 

LDR R1, [SP,#0x38+var_ 34] 

ADR RO, aMinutesD ; "Minutes: %d\n" 
BL _ 2printf 

LDR R1, [SP,#0x38+var_ 38] 

ADR RO, aSecondsD ; "Seconds: %d\n" 
BL . 2printf 

ADD SP, SP, 40x34 

POP {PC} 


Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


IDA “knows” the tm structure (because IDA “knows” the types of the arguments of 
library functions like Localtime r()), 


so it shows here structure elements accesses and their names. 


Listing 1.339: Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


PUSH {R7,LR} 

MOV R7, SP 

SUB SP, SP, 40x30 

MOVS RO, #0 ; time t * 

BLX time 

ADD R1, SP, #0x38+var_34 ; struct tm * 
STR RO, [SP,#0x38+var_ 38] 

MOV RO, SP ; time t * 

BLX  localtime r 

LDR R1, [SP,20x38-var 34.tm year] 
MOV RO, OxF44 ; "Year: %d\n" 

ADD RO, PC ; char * 

ADDW R1, R1, #0x76C 

BLX  printf 

LDR R1, [SP,#0x38+var_34.tm_mon] 
MOV RO, OxF3A ; "Month: %d\n" 

ADD RO, PC ; char * 

BLX  printf 

LDR R1, [SP,#0x38+var_34.tm_mday] 
MOV RO, OxF35 ; "Day: %d\n" 

ADD RO, PC ; char * 

BLX  printf 

LDR R1, [SP,#0x38+var_34.tm_hour] 
MOV RO, OxF2E ; "Hour: %d\n" 

ADD RO, PC ; char * 

BLX printf 

LDR R1, [SP,+0x38+var_34.tm_min] 
MOV RO, OxF28 ; "Minutes: %d\n" 
ADD RO, PC ; char * 

BLX printf 
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LDR R1, 
MOV RO, 
ADD RO, 


BLX 


ADD SP, 


POP 


00000000 
00000000 
00000004 
00000008 
0000000C 
00000010 
00000014 
00000018 
0000001C 
00000020 
00000024 
00000028 
0000002C 


tm 


tm_sec 
tm_min 
tm_hour DCD 
tm mday DCD 
tm mon 
tm year DCD 
tm wday DCD 
tm yday DCD 
tm isdst DCD 
tm gmtoff DCD 


[SP,20x38-var 34] 
OxF25 ; "Seconds: %d\n" 
PC ; char * 


| printf 


SP, #0x30 


{R7,PC} 


struc ; (sizeof=0x2C, standard type) 
DCD 
DCD 


DCD 


tm_zone DCD ? ; offset 


tm 


ends 


MIPS 


Listing 1.340: Optimizing GCC 4.4.5 (IDA) 


main: 
; IDA is 


var 40 
var 38 
seconds 
minutes 
hour 
day 
month 
year 
var 4 


lui 
addiu 
la 


not aware of structure field names, we named them manually: 


$gp, 
$sp, 
$9p, 
$ra, 
$gp, 
$t9, 
gat, 
$t9 

$a0, 
$9p, 
$a0, 
$t9, 


-0x40 
-0x38 
-0x34 
-0x30 
-0x2C 
-0x28 
-0x24 
-0x20 
-4 


( gnu local gp >> 16) 

-0x50 

( gnu local gp € OxFFFF) 
0x50-var 4($sp) 

0x50-var 40($sp) 

(time & OxFFFF) ($gp) 

$zero ; load delay slot, NOP 


$zero ; branch delay slot, NOP 
0x50-var 40($sp) 

$sp, 0x50-«var 38 

(localtime r & OxFFFF) ($gp) 
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addiu $al, $sp, 0x50+seconds 


jalr $t9 

SW $v0, Ox50+var_38($sp) ; branch delay slot 

lw $gp, Ox50+var 40($sp) 

lw $al, Ox50+year($sp) 

lw $t9, (printf € OxFFFF) ($gp) 

la $a0, $LCO # "Year: %d\n" 

jalr $t9 

addiu $al, 1900 ; branch delay slot 

lw $gp, Ox50+var 40($sp) 

lw $al, 0x50+month($sp) 

lw $t9, (printf € OxFFFF) ($gp) 

lui $a0, ($LC1 >> 16) # "Month: %d\n" 

jalr $t9 

la $a0, ($LC1 € OXFFFF) # "Month: %d\n" ; branch delay slot 
lw $gp, Ox50+var_40($sp) 

lw $al, 0x504day($sp) 

lw $t9, (printf € OxFFFF) ($gp) 

lui $20, ($LC2 >> 16) # "Day: %d\n" 

jalr $t9 

la $a0, ($LC2 € OxFFFF) # "Day: %d\n" ; branch delay slot 
lw $gp, Ox50+var 40($sp) 

lw $al, Ox50+hour($sp) 

lw $t9, (printf € OxFFFF) ($gp) 

lui $20, ($LC3 >> 16) # "Hour: %d\n" 

jalr $t9 

la $20, ($LC3 € OxFFFF) # "Hour: %d\n" ; branch delay slot 
lw $gp, Ox50+var_40($sp) 

lw $al, O0x50-«minutes($sp) 

lw $t9, (printf € OxFFFF) ($gp) 

lui $20, ($LC4 >> 16) # "Minutes: %d\n" 

jalr $t9 

la $20, ($LC4 € OxFFFF) # "Minutes: %d\n" ; branch delay slot 
lw $gp, Ox50+var_40($sp) 

lw $al, 0x50+seconds($sp) 

lw $t9, (printf € OxFFFF) ($gp) 

lui $a0, ($LC5 >> 16) # "Seconds: %d\n" 

jalr $t9 

la $a0, ($LC5 & OxFFFF) # "Seconds: %d\n" ; branch delay slot 
lw $ra, Ox50+var_4($5p) 

or gat, $zero ; load delay slot, NOP 

jr $ra 


addiu  S$sp, 0x50 


$LCO: „ascii "Year: %d\n"<0> 
$LC1: .ascii "Month: %d\n"<0> 
$LC2: .ascii "Day: %d\n"<Q> 
$LC3: „ascii "Hour: %d\n"<0> 
$LC4: .ascii "Minutes: %d\n"<0> 
$LC5: .ascii "Seconds: %d\n"<Q> 


This is an example where the branch delay slots can confuse us. 
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For example, there is the instruction addiu $al, 1900 at line 35 which adds 1900 
to the year number. 


It's executed before the corresponding JALR at line 34, do not forget about it. 


Structure as a set of values 


In order to illustrate that the structure is just variables laying side-by-side in one 
place, let's rework our example while looking at the tm structure definition again: 
listing.1.337. 


#include <stdio.h> 
#include <time.h> 


void main() 
{ 
int tm sec, tm min, tm hour, tm mday, tm mon, tm year, tm wday, tm_yday 
V , tm isdst; 
time t unix time; 


unix time-time (NULL); 
localtime r (&unix time, &tm sec); 


printf 
printf 
printf 
printf 
printf 
printf 


"Year: %d\n", tm_year+1900) ; 
"Month: %d\n", tm mon); 
"Day: %d\n", tm mday); 
"Hour: %d\n", tm hour); 
"Minutes: %d\n", tm min); 
"Seconds: %d\n", tm sec); 


p 


i 


N.B. The pointer to the tm sec field is passed into Localtime r, i.e., to the first 
element of the "structure". 


The compiler warns us: 


Listing 1.341: GCC 4.7.3 


GCC tm2.c: In function 'main': 

GCC tm2.c:11:5: warning: passing argument 2 of 'localtime r' from 7 
V incompatible pointer type [enabled by default] 

In file included from GCC tm2.c:2:0: 

/usr/include/time.h:59:12: note: expected 'struct tm *' but argument is of 2 
y type 'int *' 


But nevertheless, it generates this: 


Listing 1.342: GCC 4.7.3 


main proc near 


var 30 
var 2C 


dword ptr -30h 
dword ptr -2Ch 
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dword 
dword 
dword 
dword 
dword 
dword 
dword 


unix time 
tm sec 

tm min 

tm hour 
tm mday 
tm mon 

tm year 


push 
mov 
and 
sub 
call 
mov 
call 
mov 
lea 
mov 
lea 
mov 
call 
mov 
add 
mov 
mov 
call 
mov 
mov 
mov 
call 
mov 
mov 
mov 
call 
mov 
mov 
mov 
call 
mov 
mov 
mov 
call 
mov 
mov 
mov 
call 
leave 
retn 


main endp 


ptr -1Ch 

ptr -18h 

ptr -14h 

ptr -10h 

ptr -0Ch 

ptr -8 

ptr -4 

ebp 

ebp, esp 

esp, OFFFFFFFOh 
esp, 30h 

. main 
[esp+30h+var_30], 0 ; arg 0 
time 


[esp+30h+unix time], eax 
eax, [esp+30h+tm_ sec] 
[esp+30h+var_2C], eax 
eax, [esp+30h+unix_time] 
[esp+30h+var_30], eax 
localtime r 

eax, [esp+30h+tm_ year] 
eax, 1900 
[esp+30h+var_2C], eax 


[esp+30h+var_30], offset aYearD ; "Year: %d\n" 
printf 

eax, [esp+30h+tm_mon] 

[esp+30h+var_2C], eax 

[esp+30h+var_30], offset aMonthD ; "Month: %d\n" 
printf 

eax, [esp+30h+tm_mday] 

[esp+30h+var_2C], eax 

[esp+30h+var_30], offset aDayD ; “Day: %d\n" 
printf 

eax, [esp+30h+tm_ hour] 

[esp+30h+var_2C], eax 

[esp+30h+var_30], offset aHourD ; “Hour: %d\n" 
printf 

eax, [esp+30h+tm_ min] 

[esp+30h+var_2C], eax 

[esp+30h+var_ 30], offset aMinutesD ; "Minutes: %d\n" 
printf 

eax, [esp+30h+tm_ sec] 

[esp+30h+var_2C], eax 

[esp+30h+var_30], offset aSecondsD ; “Seconds: %d\n" 


printf 


This code is identical to what we saw previously and it is not possible to say, was it 
a structure in original source code or just a pack of variables. 
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And this works. However, it is not recommended to do this in practice. 


Usually, non-optimizing compilers allocates variables in the local stack in the same 
order as they were declared in the function. 


Nevertheless, there is no guarantee. 


By the way, some other compiler may warn about the tm year, tm mon, tm mday, 
tm hour, tm min variables, but not tm sec are used without being initialized. 


Indeed, the compiler is not aware that these are to be filled by 
localtime r() function. 


We chose this example, since all structure fields are of type int. 


This would not work if structure fields are 16-bit (WORD), like in the case of the 
SYSTEMTIME structure—GetSystemTime() will fill them incorrectly (because the lo- 
cal variables are aligned on a 32-bit boundary). Read more about it in next section: 
"Fields packing in structure" (1.30.4 on page 451). 


So, a structure is just a pack of variables laying in one place, side-by-side. We could 
say that the structure is the instruction to the compiler, directing it to hold variables 
in one place. By the way, in some very early C versions (before 1972), there were no 
structures at all [Dennis M. Ritchie, The development of the C language, (1993)]*°>. 


There is no debugger example here: it is just the same as you already saw. 


Structure as an array of 32-bit words 


#include <stdio.h> 
#include <time.h> 


void main() 

{ 
struct tm t; 
time t unix time; 
int i; 


unix time-time (NULL); 
localtime r (&unix time, &t); 


for (i20; i«9; i++) 
1 
int tmp=((int*)&t 
( 


il; 
printf ("0x%08X ) 


M 

*d)Nn", tmp, tmp); 
}; 

}; 


We just cast a pointer to structure to an array of int's. And that works! We run the 
example at 23:51:45 26-July-2014. 


155Also available as pdf 
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0x0000002D (4 
0x00000033 (5 
0x00000017 (2 
0x0000001A (2 
0x00000006 (6 
0x00000072 (1 
0x00000006 (6 
0x000000CE (2 
0x00000001 (1 


The variables here are in the same order as they are enumerated in the definition of 
the structure: 1.337 on page 440. 


Here is how it gets compiled: 


Listing 1.343: Optimizing GCC 4.8.1 


main proc near 


push ebp 

mov ebp, esp 

push esi 

push ebx 

and esp, OFFFFFFFOh 

sub esp, 40h 

mov dword ptr [esp], 0 ; timer 
lea ebx, [esp+14h] 

call time 

lea esi, [esp+38h] 

mov [esp+4], ebx > tp 

mov [esp+10h], eax 

lea eax, [esp+10h] 

mov [esp], eax ; timer 
call _localtime_r 

nop 

lea esi, [esi+0] ; NOP 


loc 80483D8: 
; EBX here is pointer to structure, 
; ESI is the pointer to the end of it. 


mov eax, [ebx] ; get 32-bit word from array 
add ebx, 4 ; next field in structure 
mov dword ptr [esp+4], offset a0x08xD ; "0x%08X (%d)\n" 
mov dword ptr [esp], 1 
mov [esp+0Ch], eax ; pass value to printf() 
mov [esp+8], eax ; pass value to printf() 
call |. printf chk 
cmp ebx, esi ; meet structure end? 
jnz short loc 80483D8 ; no - load next value then 
lea esp, [ebp-8] 
pop ebx 
pop esi 
pop ebp 
retn 
main endp 
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Indeed: the space in the local stack is first treated as a structure, and then it's 
treated as an array. 


It’s even possible to modify the fields of the structure through this pointer. 


And again, it's dubiously hackish way to do things, not recommended for use in 
production code. 


Exercise 


As an exercise, try to modify (increase by 1) the current month number, treating the 
structure as an array. 


Structure as an array of bytes 


We can go even further. Let's cast the pointer to an array of bytes and dump it: 


#include <stdio.h> 
#include <time.h> 


void main() 

{ 
struct tm t; 
time t unix time; 
int i, j; 


unix time-time (NULL); 
localtime r (&unix time, &t); 


for (i20; i«9; i++) 
1 
for (j=0; j<4; j++) 
printf ("0x%02X ", ((unsigned char*)&t)[i*4-4j]); 
printf ("An"); 
ur 
yi 


0x2D 0x00 0x00 0x00 
0x33 0x00 0x00 0x00 
0x17 0x00 0x00 0x00 
0x1A 0x00 0x00 0x00 
0x06 0x00 0x00 0x00 
0x72 0x00 0x00 0x00 
0x06 0x00 0x00 0x00 
OxCE 0x00 0x00 0x00 
0x01 0x00 0x00 0x00 


We also run this example at 23:51:45 26-July-2014 1%. The values are just the same 
as in the previous dump (1.30.3 on the previous page), and of course, the lowest 


156The time and date are the same for demonstration purposes. Byte values are fixed up. 
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byte goes first, because this is a little-endian architecture (2.2 on page 572). 


Listing 1.344: Optimizing GCC 4.8.1 


main proc near 


push ebp 

mov ebp, esp 

push edi 

push esi 

push ebx 

and esp, OFFFFFFFOh 

sub esp, 40h 

mov dword ptr [esp], 0 ; timer 
lea esi, [esp+14h] 

call time 

lea edi, [esp+38h] ; struct end 
mov [esp*4], esi ; tp 

mov [esp*10h], eax 

lea eax, [esp+10h] 

mov [esp], eax ; timer 
call _localtime_r 

lea esi, [esi+0] ; NOP 


; ESI here is the pointer to structure in local stack. 
; EDI is the pointer to structure end. 
loc_8048408: 

xor ebx, ebx ; j=0 


loc 804840A: 


movzx eax, byte ptr [esi+ebx] ; load byte 
add ebx, 1 ; j=j+1 
mov dword ptr [esp+4], offset a0x02x ; "0x%02X " 
mov dword ptr [esp], 1 
mov [esp+8], eax ; pass loaded byte to printf() 
call |. printf chk 
cmp ebx, 4 
jnz short loc 804840A 
; print carriage return character (CR) 
mov dword ptr [esp], 0Ah ; c 
add esi, 4 
call | putchar 
cmp esi, edi ; meet struct end? 
jnz short loc 8048408 ; j-0 
lea esp, [ebp-0Ch] 
pop ebx 
pop esi 
pop edi 
pop ebp 
retn 
main endp 


GNU Scientific Library: Representation of complex numbers 


This is a relatively rare case when an array is used instead of a structure, on purpose: 
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Representation of complex numbers 


Complex numbers are represented using the type :code:'gsl complex”. The 
internal representation of this type may vary across platforms and 
should not be accessed directly. The functions and macros described 
below allow complex numbers to be manipulated in a portable way. 


For reference, the default form of the :code:'gsl complex” type is 
given by the following struct:: 


typedef struct 


double dat[2]; 
} gsl complex; 


The real and imaginary part are stored in contiguous elements of a two 
element array. This eliminates any padding between the real and 

imaginary parts, :code:'dat[0]' and :code:'dat[1]', allowing the struct to 
be mapped correctly onto packed complex arrays. 


( URL ) 


1.30.4 Fields packing in structure 


One important thing is fields packing in structures. 


Let's take a simple example: 


#include <stdio.h> 


struct s 
{ 
char a; 
int b; 
char c; 
int d; 
y 
void f(struct s s) 
{ 
printf ("a=%d; b=%d; c=%d; d=%d\n", s.a, s.b, s.c, s.d); 
yi 
int main() 
{ 
struct s tmp; 
tmp.a-1; 
tmp.b=2; 
tmp.c=3; 
tmp.d=4; 
f (tmp); 
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PE 


As we see, we have two char fields (each is exactly one byte) and two more —int 


(each — 4 bytes). 


x86 


This compiles to: 


Listing 1.345: MSVC 2012 /GS- /ObO 


_tmp$ = -16 

main PROC 
push ebp 
mov ebp, esp 
sub esp, 16 
mov BYTE PTR tmp$[ebp], 1 ; 
mov DWORD PTR _tmp$[ebp+4], 2 ; 
mov BYTE PTR _tmp$[ebp+8], 3 ; 
mov DWORD PTR _tmp$[ebp+12], 4 ; 
sub esp, 16 ; 
structure 
mov eax, esp 
mov ecx, DWORD PTR tmp$[ebp] ; 
mau DWORD PTR [eax], ecx 
mov edx, DWORD PTR _tmp$[ebp+4] 
mov DWORD PTR [eax+4], edx 
mov ecx, DWORD PTR _tmp$[ebp+8] 
mov DWORD PTR [eax+8], ecx 
mov edx, DWORD PTR _tmp$[ebp+12] 
mov DWORD PTR [eax+12], edx 
call f 
add esp, 16 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 

main ENDP 

_s$ = 8 ; size = 16 

?f@@YAXUS@@@Z PROC ; f 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR _s$[ebp+12] 
push eax 
movsx ecx, BYTE PTR _s$[ebp+8] 
push ecx 
mov edx, DWORD PTR _s$[ebp+4] 
push edx 
movsx eax, BYTE PTR _s$[ebp] 
push eax 
push OFFSET $SG3842 
call printf 


; set field a 
; set field b 


set field c 
set field d 


; allocate place for temporary 


copy our structure to the temporary 
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add esp, 20 

pop ebp 

ret 0 
?F@@YAXUS@@@Z ENDP ; f 
_ TEXT ENDS 


We pass the structure as a whole, but in fact, as we can see, the structure is being 
copied to a temporary one (a place in stack is allocated in line 10 for it, and then all 
4 fields, one by one, are copied in lines 12 ... 19), and then its pointer (address) is 
to be passed. 


The structure is copied because it's not known whether the f() function going to 
modify the structure or not. If it gets changed, then the structure in main() has to 
remain as it has been. 


We could use C/C++ pointers, and the resulting code will be almost the same, but 
without the copying. 


As we can see, each field's address is aligned on a 4-byte boundary. That's why each 
char occupies 4 bytes here (like int). Why? Because it is easier for the CPU to access 
memory at aligned addresses and to cache data from it. 


However, it is not very economical. 


Let's try to compile it with option (/Zp1) (/Zp[n] pack structures on n-byte boundary). 
Listing 1.346: MSVC 2012 /GS- /Zp1 


main PROC 
push ebp 
mov ebp, esp 
sub esp, 12 
mov BYTE PTR tmp$[ebp], 1 ; set field a 
mov DWORD PTR tmp$[ebp+1], 2 ; set field b 
mov BYTE PTR tmp$[ebp+5], 3 ; set field c 
mov DWORD PTR tmp$[ebp+6], 4 ; set field d 


sub esp, 12 
structure 
mov eax, esp 


mov ecx, DWORD PTR tmp$[ebp] ; copy 10 bytes 
mov DWORD PTR [eax], ecx 

mov edx, DWORD PTR _tmp$[ebp+4] 

mov DWORD PTR [eax+4], edx 

mov cx, WORD PTR _tmp$[ebp+8] 

mov WORD PTR [eax+8], cx 


; allocate place for temporary 


call af 
add esp, 12 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 

main ENDP 


_ TEXT SEGMENT 
_s$ = 8 ; size = 10 
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?F@@YAXUS@@@Z PROC md 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR _s$[ebp+6] 
push eax 
movsx ecx, BYTE PTR _s$[ebp+5] 
push ecx 
mov edx, DWORD PTR _s$[ebp+1] 
push edx 
movsx eax, BYTE PTR _s$[ebp] 
push eax 


push OFFSET $5G3842 
call printf 
add esp, 20 


pop ebp 
ret 0 
?F@@YAXUs@@@Z ENDP UE 


Now the structure takes only 10 bytes and each char value takes 1 byte. What does 
it give to us? Size economy. And as drawback —the CPU accessing these fields 
slower than it could. 


The structure is also copied in main(). Not field-by-field, but directly 10 bytes, using 
three pairs of MOV. Why not 4? 


The compiler decided that it's better to copy 10 bytes using 3 MOV pairs than to copy 
two 32-bit words and two bytes using 4 MOV pairs. 


By the way, such copy implementation using MOV instead of calling the memcpy() 
function is widely used, because it's faster than a call to memcpy ( ) —for short blocks, 
of course: 3.14.1 on page 640. 


As it can be easily guessed, if the structure is used in many source and object files, 
all these must be compiled with the same convention about structures packing. 


Aside from MSVC /Zp option which sets how to align each structure field, there is 
also the #pragma pack compiler option, which can be defined right in the source 
code. It is available in both MSVC!?7/and GCC?^5, 


Let's get back to the SYSTEMTIME structure that consists of 16-bit fields. How does 
our compiler know to pack them on 1-byte alignment boundary? 


WinNT.h file has this: 
Listing 1.347: WinNT.h 


#include "pshpackl.h" 


And this: 
Listing 1.348: WinNT.h 


#include "pshpack4.h" // 4 byte packing is the default 


157MSDN: Working with Packing Structures 
158Structure-Packing Pragmas 
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The file PshPack1.h looks like: 
Listing 1.349: PshPack1.h 


#if ! (defined(lint) || defined(RC_INVOKED) ) 

#if ( MSC VER >= 800 && !defined( M I86)) || defined( PUSHPOP SUPPORTED) 
#pragma warning(disable:4103) 

sif !(defined( MIDL PASS )) || defined(  midl ) 
#pragma pack(push,1) 

#else 

#pragma pack(1) 

#endif 

#else 

#pragma pack(1) 

#endif 

#endif /* ! (defined(lint) || defined(RC INVOKED) ) */ 


This tell the compiler how to pack the structures defined after #pragma pack. 
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OllyDbg + fields are packed by default 


Let's try our example (where the fields are aligned by default (4 bytes)) in OllyDbg: 


CPU - main thread, module daa Oj xl 
A1 T i 
r 


SP 
DWORD PTR SS: CARG.4] 
BYTE PTR SS: CARG.3] 
DWORD PTR SS: CARG.2] 
BYTE PTR SS: [ARG.1] an 
T 91373000 i ASC i 81371018 pack ing. 01371010 
D PTR DS: C<&MSVCR116. printf >] ca S atFFFFFFFF) 
@( FFFFFFFF) 
at FFFFFFFF) 
BLFFFFFFFF) 


7TEFDDaaatFFF) 
@(FFFFFFFF) 


Stack [0034FCB4]=01 
EAX= 


LastErr 00000000 ERROR SUCCESS 
2 D S,PE,GE,G) 


Figure 1.105: OllyDbg: Before printf () execution 


We see our 4 fields in the data window. 


But where do the random bytes (0x30, 0x37, 0x01) come from, that are next to the 
first (a) and third (c) fields? 


By looking at our listing 1.345 on page 452, we can see that the first and third fields 
are char, therefore only one byte is written, 1 and 3 respectively (lines 6 and 8). 


The remaining 3 bytes of the 32-bit words are not being modified in memory! Hence, 
random garbage is left there. 


This garbage doesn’t influence the printf() output in any way, because the val- 
ues for it are prepared using the MOVSX instruction, which takes bytes, not words: 
listing.1.345 (lines 34 and 38). 


By the way, the MOVSX (sign-extending) instruction is used here, because char is 
signed by default in MSVC and GCC. If the unsigned char data type or uint8 t was 
used here, MOVZX instruction would have been used instead. 
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OllyDbg + fields aligning on 1 byte boundary 


Things are much clearer here: 4 fields occupy 10 bytes and the values are stored 
side-by-side 


CPU - main thread, module packing 


Registers (FPU) 
S: [EBP+BE7 


: [ARG. 2+1] 


pack ing. 00DE1010 


ØLFFFFFFFF) 
ØLFFFFFFFF) 
ØLFFFFFFFF) 
atFFFFFFFF) 
TEFDDOaaatFFF) 


BCFFFFFFFF) 


RETURN from pac 


OFFSET packing. 


Figure 1.106: OllyDbg: Before printf () execution 


ARM 
Optimizing Keil 6/2013 (Thumb mode) 


Listing 1.350: Optimizing Keil 6/2013 (Thumb mode) 


. text: 0000003E exit ; CODE XREF: f+16 

. text: 0000003E 05 BO ADD SP, SP, #0x14 

. text: 00000040 00 BD POP {PC} 

. text: 00000280 f 

.text:00000280 

.text:00000280 var 18 - -0x18 

.text:00000280 a = -0x14 

. text: 00000280 b = -0x10 

. text: 00000280 C = -0xC 

.text:00000280 d -8 

.text:00000280 

.text:00000280 OF B5 PUSH {RO-R3, LR} 
.text:00000282 81 BO SUB SP, SP, £4 
.text:00000284 04 98 LDR RO, [SP,#16] ;d 
.text:00000286 02 9A LDR R2, [SP,#8] Pb 
.text:00000288 00 90 STR RO, [SP] 
.text:0000028A 68 46 MOV RO, SP 
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.text:0000028C 03 7B LDRB R3, [RO,+12] "Ee 
E 01 79 LDRB R1, [RO,+4] ;a 
.text:00000290 59 AQ ADR RO, aADBDCDDD ; "a=%d; b 
c=%d; d=%d\n" 
. text: 00000292 05 FO AD FF BL _ 2printf 
| text:00009296 D2 E6 B exit 


As we may recall, here a structure is passed instead of pointer to one, and since the 
first 4 function arguments in ARM are passed via registers, the structure's fields are 


passed via RO-R3. 


LDRB loads one byte from memory and extends it to 32-bit, taking its sign into ac- 
count. This is similar to MOVSX in x86. Here it is used to load fields a and c from the 


structure. 


One more thing we spot easily is that instead of function epilogue, there is jump to 
another function's epilogue! Indeed, that was quite different function, not related 
in any way to ours, however, it has exactly the same epilogue (probably because, it 
hold 5 local variables too (5 + 4 = 0x14)). 


Also it is located nearby (take a look at the addresses). 


Indeed, it doesn't matter which epilogue gets executed, if it works just as we need. 


Apparently, Keil decides to reuse a part of another function to economize. 


The epilogue takes 4 bytes while jump—only 2. 


ARM 4 Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


Listing 1.351: Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


var C = -0xC 


PUSH 
MOV 
SUB 
MOV 
MOV 
MOVW 
SXTB 
MOVT.W 
STR 
ADD 
SXTB 
MOV 
BLX 
ADD 
POP 


{R7,LR} 


R7, 


SP, 


SP 

SP, #4 

R1 ; b 

RO ; a 

#0xF10 ; "a=%d; b=%d; c=%d; d=%d\n" 
R1 ; prepare a 

#0 

[SP,#0xC+var_C] ; place d to stack for printf() 
PC ; format-string 

R2 ; prepare c 

R9 ; b 


| printf 


SP, #4 


{R7, PC} 


SXTB (Signed Extend Byte) is analogous to MOVSX in x86. All the rest—just the same. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


WO -4 OY Ul un Aa 


459 


MIPS 
Listing 1.352: Optimizing GCC 4.4.5 (IDA) 
f: 
var 18 - -0x18 
var 10 = -0x10 
var_4 = -4 
arg 0 = 0 
arg 4 = 4 
arg 8 = 8 
arg C = OxC 
; $a0-s.a 
; $al=s.b 
; $a2=S.C 
; $a3=s.d 
lui $gp, ( gnu local gp >> 16) 
addiu $sp, -0x28 
la $gp, ( gnu local gp € OxFFFF) 
SW $ra, 0x28+var_4($sp) 
sw $gp, 0x28+var_10($sp) 
; prepare a byte from 32-bit big-endian integer: 
sra $t0, $a0, 24 
move $v1, $al 
; prepare a byte from 32-bit big-endian integer: 
sra $v0, $a2, 24 
lw $t9, (printf € OxFFFF) ($gp) 
sw $a0, 0x28+arg_0($sp) 
lui $a0, ($LCO >> 16) # “a=%d; b=%d; c=%d; d=%d\n" 
SW $a3, Ox28+var_18($sp) 
SW $al, 0x28+arg_4($sp) 
SW $a2, Ox28+arg 8($sp) 
SW $a3, Ox28+arg C($sp) 
la $a0, ($LCO € OxFFFF) # "a=%d; b=%d; c=%d; d=%d\n" 
move $al, $t0 
move $a2, $v1 
jalr $t9 
move $a3, $v0 ; branch delay slot 
lw $ra, 0x28+var_4($5p) 
or $at, $zero ; load delay slot, NOP 
jr $ra 
addiu  $sp, 0x28 ; branch delay slot 
$LCO: „ascii "a-*sd; b=%d; c=%d; d=%sd\n"<0> 


Structure fields come in registers $A0..$A3 and then get reshuffled into $A1..$A3 for 
printf(), while 4th field (from $A3) is passed via local stack using SW. 


But there are two SRA (“Shift Word Right Arithmetic”) instructions, which prepare 
char fields. Why? 


MIPS is a big-endian architecture by default 2.2 on page 572, and the Debian Linux 
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we work in is big-endian as well. 


So when byte variables are stored in 32-bit structure slots, they occupy the high 
31..24 bits. 


And when a char variable needs to be extended into a 32-bit value, it must be shifted 
right by 24 bits. 


char is a signed type, so an arithmetical shift is used here instead of logical. 


One more word 


Passing a structure as a function argument (instead of a passing pointer to structure) 
is the same as passing all structure fields one by one. 


If the structure fields are packed by default, the f() function can be rewritten as: 


void f(char a, int b, char c, int d) 


1 
yi 


printf ("a=%d; b=%d; c=%d; d=%d\n", a, b, c, d); 


And that leads to the same code. 


1.30.5 Nested structures 


Now what about situations when one structure is defined inside of another? 


#include <stdio.h> 


struct inner_struct 


{ 
int a; 
int b; 
Fi 
struct outer_struct 
{ 
char a; 
int b; 
struct inner struct c; 
char d; 
int e; 
i 


void f(struct outer struct s) 


printf ("a=%d; b=%d; c.a=%d; c.b=%d; d=%d; e=%d\n", 
s.a, S.b, s.c.a, s.c.b, s.d, s.e); 
ur 


int main() 


1 


struct outer struct s; 
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+>—)0000nn YN 


i 


...in this case, both inner struct fields are to be placed between the a,b and d,e 
fields of the outer struct. 


Let's comp 


ile (MSVC 2010): 
Listing 1.353: Optimizing MSVC 2010 /ObO 


$SG2802 DB 


_ TEXT S 

_s$ = 8 

_f PROC 
mov 
movsx 
mov 
push 
mov 
push 
mov 
push 
movsx 
push 
push 
push 
push 
call 
add 
ret 

f ENDP 


_s$ = -24 
main P 
sub 
push 
push 
push 
mov 
sub 
mov 

; from thi 
mov 
mov 
mov 
mov 
lea 


'a=%d; b=%d; c.a=%d; c.b=%d; d=%d; e=%d', OaH, OOH 


EGMENT 


eax, 
ecx, 
edx, 
eax 
eax, 
ecx 
ecx, 
edx 
edx, 
eax 
ecx 
edx 
OFFSET $SG2802 ; 
| printf 

esp, 28 

0 


DWORD PTR _s$[esp+16] 
BYTE PTR _s$[esp+12] 
DWORD PTR _s$[esp+8] 


DWORD PTR _s$[esp+8] 
DWORD PTR _s$[esp+8] 


BYTE PTR _s$[esp+8] 


'a=%d; b=%d; c.a=%d; 


ROC 

esp, 24 

ebx 

esi 

edi 

ecx, 2 

esp, 24 

eax, esp 

s moment, EAX is synonymous to ESP: 
BYTE PTR _s$[esp+60], 1 
ebx, DWORD PTR _s$[esp+60] 
DWORD PTR [eax], ebx 
DWORD PTR [eax+4], ecx 
edx, DWORD PTR [ecx+98] 


c.b=%d; d=%d; e=% 
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lea esi, DWORD PTR [ecx+99] 
lea edi, DWORD PTR [ecx+2] 

mov DWORD PTR [eax+8], edx 
mov BYTE PTR _s$[esp+76], 3 
mov ecx, DWORD PTR _s$[esp+76] 
mov DWORD PTR [eax+12], esi 
mov DWORD PTR [eax+16], ecx 
mov DWORD PTR [eax+20], edi 


call f 
add esp, 24 
pop edi 
pop esi 
xor eax, eax 
pop ebx 
add esp, 24 
ret 0 

main ENDP 


One curious thing here is that by looking onto this assembly code, we do not even see 
that another structure was used inside of it! Thus, we would say, nested structures 
are unfolded into /inear or one-dimensional structure. 


Of course, ifwe replace the struct inner struct c; declaration with struct inner struct 
*c; (thus making a pointer here) the situation will be quite different. 
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OllyDbg 


Let's load the example into OllyDbg and take a look at outer struct in memory: 


CPU - main thread, module nested 


18 SS: [ARG.6] 
4 14 ARG 


TR CARG.5] 


DUSA BYTE (3.5 T 
18 DU : CARG. 41 (S 2x »2n2a 


Š nested. 00E73303 
18 OU EAX, DWORD PTR SS:IRRG.31 — E01 
DWORD PTR SS: CARG.2] > BODSFESO 
D SS: LARG. 11 SI 8880065 

kh v aaaaaaa4 
00E71000 nested. GGE71006 


at FFFFFFFF) 
Bt FFFFFFFF) 
@( FFFFFFFF) 
@( FFFFFFFF) 
rEFDDaaatFFF) 
Bt FFFFFFFF) 


a LastErr 
66006262 (NO,NB,NE, 


Figure 1.107: OllyDbg: Before printf () execution 


That’s how the values are located in memory: 
* (outer struct.a) (byte) 1 + 3 bytes of random garbage; 
* (outer struct.b) (32-bit word) 2; 
* (inner struct.a) (32-bit word) 0x64 (100); 
* (inner struct.b) (32-bit word) 0x65 (101); 
* (outer struct.d) (byte) 3 + 3 bytes of random garbage; 
( 


* (outer struct.e) (32-bit word) 4. 


1.30.6 Bit fields in a structure 
CPUID example 


The C/C++ language allows to define the exact number of bits for each structure 
field. It is very useful if one needs to save memory space. For example, one bit is 
enough for a bool variable. But of course, it is not rational if speed is important. 


Let's consider the CPUID'??instruction example. This instruction returns information 
about the current CPU and its features. 


If the EAX is set to 1 before the instruction's execution, CPUID returning this informa- 
tion packed into the EAX register: 


159wikipedia 
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3:0 (4 bits) 
7:4 (4 bits) 
11:8 (4 bits) 
13:12 (2 bits) 
19:16 (4 bits) 
27:20 (8 bits) 


Stepping 

Model 

Family 
Processor Type 
Extended Model 
Extended Family 


MSVC 2010 has CPUID macro, but GCC 4.4.1 does not. So let's make this function 


by ourselves for GCC with the help of its built-in assembler**0. 


#include <stdio.h> 


#ifdef — GNUC - 


static inline void cpuid(int code, int *a, int *b, int *c, int *d) { 
asm volatile("cpuid":"=a"(*a),"=b"(*b),"=c"(*c),"=d"(*d):"a"(code)); 


} 
#endif 


#ifdef _MSC_VER 
#include <intrin. 
#endif 


h> 


struct CPUID 1 EAX 


{ 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 


int main() 


struct CPUID 


int b[4]; 
#ifdef MSC VER 

_ cpuid(b,1); 
#endif 


#ifdef  GNUC 


stepping:4; 
model:4; 

family id:4; 
processor type:2; 
reserved1:2; 


extended model id:4; 
extended family id:8; 


reserved2:4; 


1 EAX *tmp; 


cpuid (1, &b[0], &b[1], &b[2], &b[3]); 


Hendif 


tmp=(struct CPUID 1 EAX *)&b[0]; 


printf ("stepping=%d\n", tmp->stepping) ; 


printf ("model=%d\n", tmp->model) ; 
printf ("family_id=%d\n", 


160More about internal GCC assembler 


tmp->family_id); 
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printf ("processor _type=%d\n", tmp->processor type); 
printf ("extended model _id=%d\n", tmp->extended model id); 
printf ("extended family id=%d\n", tmp->extended family id); 


return 0; 


yi 


After CPUID fills EAX/EBX/ECX/EDX, these registers are to be written in the b[] array. 
Then, we have a pointer to the CPUID_1_EAX structure and we point it to the value 
in EAX from the b[] array. 


In other words, we treat a 32-bit int value as a structure. Then we read specific bits 
from the structure. 


MSVC 


Let's compile it in MSVC 2008 with /0x option: 
Listing 1.354: Optimizing MSVC 2008 


_b$ = -16 ; size = 16 


main PROC 
sub esp, 16 
push ebx 
xor ecx, ecx 
mov eax, 1 
cpuid 
push esi 


lea esi, DWORD PTR _b$[esp+24] 
mov DWORD PTR [esi], eax 

mov DWORD PTR [esi+4], ebx 
mov DWORD PTR [esi+8], ecx 
mov DWORD PTR [esi+12], edx 


mov esi, DWORD PTR _b$[esp+24] 


mov eax, esi 
and eax, 15 
push eax 


push OFFSET $5G15435 ; 'stepping=%d', OaH, 00H 
call printf 


mov ecx, esi 
shr ecx, 4 
and ecx, 15 
push ecx 


push OFFSET $5615436 ; ‘model=%d', 0aH, 00H 
call printf 


mov edx, esi 
shr edx, 8 
and edx, 15 
push edx 
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push 
call 


mov 
shr 
and 
push 
push 
call 


mov 
shr 
and 
push 
push 
call 


shr 
and 
push 
push 
call 
add 


pop 


xor 
pop 


add 
ret 
main 


OFFSET $5G15437 ; 


| printf 


eax, esi 
eax, 12 
eax, 3 
eax 


OFFSET $56G15438 ; 


| printf 


ecx, esi 
ecx, 16 
ecx, 15 
ecx 


OFFSET $5615439 ; 


| printf 


esi, 20 
esi, 255 
esi 


OFFSET $5G15440 ; 


| printf 
esp, 48 
esi 


eax, eax 
ebx 


esp, 16 
0 
ENDP 


, 


, 


, 


, 


‘family id=%d', OaH, 00H 


‘processor type=%d', OaH, 00H 


‘extended model id=%d', OaH, OOH 


‘extended family id=%d', OaH, 00H 


The SHR instruction shifting the value in EAX by the number of bits that must be 
skipped, e.g., we ignore some bits at the right side. 


The AND instruction clears the unneeded bits on the left, or, in other words, leaves 
only those bits in the EAX register we need. 
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MSVC + OllyDbg 


Let'sload our example into OllyDbg and see, what values are set in EAX/EBX/ECX/EDX 
after the execution of CPUID: 


CPU - main thread, module CPUID 


$ SS3EC 18 SUB ESP, 18 
* 53 PUSH_EBX 
XOR ECX, ECX 
DU EAX, 1 


3309 
BS 01000000 
BFAZ 


56 H ESI 
807424 08 | LEA ESI, (LOCAL. 31 
8906 MOU DWORD PTR DS:LESII,ERX 
DWORD PTR DS: [ESIH], EBX 
DWORD PTR DS:CESI+8], ECX ut 
DWORD PTR DS:LESI*8C,EDX . 20491090 
ESI, DUQRD PTR SS: CLOCAL. 33 = BtFEEEEEEE) 
ND EAX, DOBABBOF hd copiada 
H EAR 7 : 
acFFFFFFFF) 
7EFDDaaat FFF) 
@(FFFFFFFF) 


OR_SUCCESS 


RETURN from CPU 


RETURN from CPU 
RETURN from CPU 


"P()" 


Figure 1.108: OllyDbg: After CPUID execution 


EAX has 0x000206A7 (my CPU is Intel Xeon E3-1220). 
This is 0600000000000000100000011010100111 in binary form. 


Here is how the bits are distributed by fields: 


field in binary form | in decimal form 
reserved2 0000 0 
extended family id | 00000000 0 
extended model id | 0010 2 
reserved1 00 0 
processor id 00 0 
family_id 0110 6 
model 1010 10 
stepping 0111 7 
Listing 1.355: Console output 

stepping=7 

model=10 

family id=6 


processor_type=0 
extended model id-2 
extended family id-0 
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GCC 


Let's try GCC 4.4.1 with -03 option. 


Listing 1.356: Optimizing GCC 4.4.1 


main 

push 
mov 
and 
push 
mov 
push 
mov 
sub 
cpuid 
mov 
and 
mov 
mov 
mov 
call 
mov 
shr 
and 
mov 
mov 
mov 
call 
mov 
shr 
and 
mov 
mov 
mov 
call 
mov 
shr 
and 
mov 
mov 
mov 
call 
mov 
shr 
shr 
and 
and 
mov 
mov 


proc near ; DATA XREF: _start+17 
ebp 
ebp, esp 
esp, OFFFFFFFOh 
esi 
esi, 1 
ebx 
eax, esi 
esp, 18h 


esi, eax 

eax, OFh 

[esp+8], eax 

dword ptr [esp+4], offset aSteppingD ; “stepping=%d\n" 
dword ptr [esp], 1 

|. printf chk 

eax, esi 

eax, 4 

eax, OFh 

[esp+8], eax 

dword ptr [esp+4], offset aModelD ; "model=%d\n" 
dword ptr [esp], 1 

|. printf chk 

eax, esi 

eax, 8 

eax, OFh 

[esp+8], eax 

dword ptr [esp+4], offset aFamily idD ; "family id=%d\n" 
dword ptr [esp], 1 

|. printf chk 

eax, esi 

eax, OCh 

eax, 3 

[esp+8], eax 

dword ptr [esp+4], offset aProcessor type ; "processor type=%d\n" 
dword ptr [esp], 1 

|. printf chk 

eax, esi 

eax, 10h 

esi, 14h 

eax, OFh 

esi, OFFh 

[esp+8], eax 

dword ptr [esp+4], offset aExtended model ; 


"extended model id=%d\n" 


mov 
call 
mov 


dword ptr [esp], 1 
|. printf chk 
[esp+8], esi 
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mov 
mov 
call 
add 
xor 
pop 
pop 
mov 
pop 
retn 

main 


dword ptr [esp+4], offset unk 80486D0 


dword ptr [esp], 1 


|. printf chk 
esp, 18h 
eax, eax 
ebx 
esi 
esp, ebp 
ebp 
endp 


Almost the same. The only thing worth noting is that GCC somehow combines the 
calculation of 
extended model id andextended family id into one block, instead of calculating 
them separately before each printf() call. 


Handling float data type as a structure 


As we already noted in the section about FPU (1.25 on page 275), both float and 
double types consist of a sign, a significand (or fraction) and an exponent. But will 
we be able to work with these fields directly? Let's try this with float. 


3130 2322 


0 


S| exponent 


mantissa or fraction 


( S — sign ) 


#include 
#include 
#include 
#include 


<stdio.h> 

<assert.h> 
<stdlib.h> 
<memory.h> 


struct float_as struct 


{ 
unsigned int fraction : 23; // fractional part 
unsigned int exponent : 8; // exponent + Ox3FF 
unsigned int sign : 1; // sign bit 
$; 
float f(float _in) 
1 
float f=_in; 
struct float as struct t; 
assert (sizeof (struct float as struct) -- sizeof (float)); 


memcpy (&t, &f, sizeof (float)); 


t.sign-1; // set negative sign 
t.exponent=t.exponent+2; // multiply d by 2"(n here is 2) 
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memcpy (&f, &t, sizeof (float)); 


return f; 
ur 
int main() 
1 
printf ("%f\n", f(1.234)); 
i 


The float as struct structure occupies the same amount of memory as float, i.e., 


4 bytes or 32 bits. 


Now we are setting the negative sign in the input value and also, by adding 2 to the 


exponent, we thereby multiply the whole number by 2?, i.e., by 4. 
Let's compile in MSVC 2008 without optimization turned on: 


Listing 1.357: Non-optimizing MSVC 2008 


t$ = -8 ; size = 4 
f$ = -4 ; size = 4 
| in$28 ; size = 4 
?F@@YAMM@Z PROC ; f 
push ebp 
mov ebp, esp 
sub esp, 8 


fld DWORD PTR — in$[ebp] 
fstp DWORD PTR f$[ebp] 


push 4 

lea eax, DWORD PTR f$[ebp] 
push eax 

lea ecx, DWORD PTR  t$[ebp] 
push ecx 

call |. memcpy 


add esp, 12 


mov edx, DWORD PTR t$[ebp] 
or edx, -2147483648 ; 80000000H - set minus sign 
mov DWORD PTR t$[ebp], edx 


mov eax, DWORD PTR  t$[ebp] 
shr eax, 23 ; 00000017H - drop significand 


and eax, 255 ; 000000ffH - leave here only exponent 

add eax, 2 ; add 2 to it 

and eax, 255 ; 000000ffH 

shl eax, 23 ; 00000017H - shift result to place of bits 30:23 


mov ecx, DWORD PTR _t$[ebp] 
and ecx, -2139095041 ; 807fffffH - drop exponent 


; add original value without exponent with new calculated exponent: 
or ecx, eax 
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mov DWORD PTR t$[ebp], ecx 


push 4 

lea edx, DWORD PTR _t$[ebp] 
push edx 

lea eax, DWORD PTR  f$[ebp] 
push eax 

call | memcpy 


add esp, 12 


fld DWORD PTR _f$[ebp] 


mov esp, ebp 

pop ebp 

ret 0 
?f@@YAMM@Z ENDP + f 


A bit redundant. If it was compiled with /0x flag there would be no memcpy () call, the 
f variable is used directly. But it is easier to understand by looking at the unoptimized 
version. 


What would GCC 4.4.1 with -03 do? 
Listing 1.358: Optimizing GCC 4.4.1 


; (float) 
public _Z1ff 
_Z1ff proc near 


var_4 - dword ptr -4 
arg 0 - dword ptr 8 
push ebp 
mov ebp, esp 
sub esp, 4 
mov eax, [ebp«arg 0] 
or eax, 80000000h ; set minus sign 
mov edx, eax 
and eax, 807FFFFFh ; leave only sign and significand in EAX 
shr edx, 23 ; prepare exponent 
add edx, 2 ; add 2 
movzx edx, dl ; clear all bits except 7:0 in EDX 
shl edx, 23 ; shift new calculated exponent to its place 
or eax, edx ; join new exponent and original value without 
exponent 
mov [ebp-var 4], eax 
fld [ebp+var_4] 
leave 
retn 
_Z1ff endp 


public main 
main proc near 
push ebp 
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mov ebp, esp 

and esp, OFFFFFFFOh 

sub esp, 10h 

fld ds:dword 8048614 ; -4.936 
fstp qword ptr [esp+8] 

mov dword ptr [esp+4], offset asc 8048610 ; "%f\n" 
mov dword ptr [esp], 1 

call |. printf chk 

xor eax, eax 

leave 

retn 


main  endp 


The f() function is almost understandable. However, what is interesting is that 
GCC was able to calculate the result of f (1.234) during compilation despite all this 
hodge-podge with the structure fields and prepared this argument to printf() as 
precalculated at compile time! 


1.30.7 Exercises 


* http://challenges.re/71 
* http://challenges.re/72 


1.31 The classic struct bug 


This is a classic struct bug. 


A sample definition: 


struct test 
1 
int fieldl; 
int field2; 
ur 


And then C files: 


void setter(struct test *t, int a, int b) 
1 
t->fieldl=a; 
t->field2=b; 
i 


#include <stdio.h> 


void printer(struct test *t) 
{ 
printf ("%d\n", t->field1); 
printf ("%d\n", t->field2); 
F 
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So far so good. 
Now you add a third field into the structure, some place between two fields: 


struct test 


1 
int fieldl; 
int inserted; 
int field2; 
ur 


And you probably modify setter() function, but forget about printer(): 


void setter(struct test *t, int a, int b, int c) 


1 
t->fieldl=a; 
t->inserted=b; 
t->field2=c; 
ur 


You compile your project, but the C file where printer() is residing, isn’t recompiling, 
because your IDE!9! or build system has no idea that module depends on a test struct 
definition. Maybe because #include <new.h> is omitted. Or maybe, new. h header 
file is included in printer.c via some other header file. The object file remains 
untouched (IDE thinks it doesn't need to be recompiled), while setter() function is 
already a new version. These two object files (old and new) eventually linked into 
an executable file. 


Then you run it, and the setter() sets 3 fields at +0, +4 and +8 offsets. However, 
the printer() only knows about 2 fields, and gets them from +0 and +4 offsets 
during printing. 


This leads to very obscure and nasty bugs. The reason is that IDE or build system or 
Makefile doesn't know the fact that both C files (or modules) depends on the header 
file with test definition. A popular remedy is to clean everything and recompile. 


This is true for C++ classes as well, since they works just like structures: 3.21.1 on 
page 682. 


This is a C/C++’s malady, and a source of criticism, yes. Many newer PLs has better 
support of modules and interfaces. But keep in mind, when C compiler was cre- 
ated: 1970s, on old PDP computers. So everything was simplified down to this by C 
creators. 


1.32 Unions 


C/C++ union is mostly used for interpreting a variable (or memory block) of one data 
type as a variable of another data type. 
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1.32.1 Pseudo-random number generator example 


If we need float random numbers between 0 and 1, the simplest thing is to use a 
PRNG like the Mersenne twister. It produces random unsigned 32-bit values (in other 
words, it produces random 32 bits). Then we can transform this value to float and 
then divide it by RAND MAX (OxFFFFFFFF in our case)—we getting a value in the 0..1 
interval. 


But as we know, division is slow. Also, we would like to issue as few FPU operations 
as possible. Can we get rid of the division? 


Let's recall what a floating point number consists of: sign bit, significand bits and 
exponent bits. We just have to store random bits in all significand bits to get a 
random float number! 


The exponent cannot be zero (the floating number is denormalized in this case), so 
we are storing 0601111111 to exponent—this means that the exponent is 1. Then we 
filling the significand with random bits, set the sign bit to 0 (which means a positive 
number) and voilà. The generated numbers is to be between 1 and 2, so we must 
also subtract 1. 


A very simple linear congruential random numbers generator is used in my exam- 
ple19?, it produces 32-bit numbers. The PRNG is initialized with the current time in 
UNIX timestamp format. 


Here we represent the float type as an union—it is the C/C++ construction that 
enables us to interpret a piece of memory as different types. In our case, we are 
able to create a variable of type union and then access to it as it is float or as it is 
uint32 t. It can be said, it is just a hack. A dirty one. 


The integer PRNG code is the same as we already considered: 1.29 on page 424. So 
this code in compiled form is omitted. 


#include <stdio.h> 
#include <stdint.h> 
#include <time.h> 


// integer PRNG definitions, data and routines: 


// constants from the Numerical Recipes book 
const uint32_t RNG a=1664525; 

const uint32 t RNG c-1013904223; 

uint32 t RNG state; // global variable 


void my srand(uint32 t i) 


RNG state-i; 
u 


uint32 t my rand() 


1 
RNG state-RNG state*RNG a+RNG c; 
return RNG state; 
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y 
// FPU PRNG definitions and routines: 


union uint32 t float 


1 
uint32 t i; 
float f; 
}; 
float float_rand() 
{ 
union uint32_t_float tmp; 
tmp.i-my rand() & 0x007fffff | 0x3F800000; 
return tmp.f-1; 
$; 
// test 
int main() 
1 
my srand(time(NULL)); // PRNG initialization 
for (int i20; i«100; i++) 
printf ("%f\n", float rand()); 
return 0; 
$; 
x86 
Listing 1.359: Optimizing MSVC 2010 
$SG4238 DB '%f', OaH, OOH 
__real@3ff0000000000000 DQ 03ff0000000000000r zl 
tv130 = -4 
_tmp$ = -4 
?float_rand@@YAMXZ PROC 
push ecx 


call ?my_rand@@YAIXZ 
; EAX-pseudorandom value 

and eax, 8388607 ; 007fffffH 

or eax, 1065353216 ; 3f800000H 
; EAX=pseudorandom value & 0x007fffff | Ox3f800000 
; store it into local stack: 


mov DWORD PTR tmp$[esp-4], eax 
; reload it as float point number: 
fld DWORD PTR _tmp$[esp+4] 


; subtract 1.0: 
fsub QWORD PTR _ real@3ff0000000000000 
; store value we got into local stack and reload it: 
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; these instructions are redundant: 
fstp DWORD PTR tv130[esp+4] 


fld DWORD PTR tv130[esp+4] 
pop ecx 
ret 0 


?float_rand@@YAMXZ ENDP 


main PROC 

push esi 

xor eax, eax 

call time 

push eax 

call ?my_srand@@YAXI@Z 

add esp, 4 

mov esi, 100 
$LL3@main: 


call ?float_rand@@YAMXZ 


sub esp, 8 


fstp QWORD PTR [esp] 
push OFFSET $5G4238 


call _ printf 
add esp, 12 
dec esi 
jne SHORT $LL3@main 
xor eax, eax 
pop esi 
ret 0 
main  ENDP 


Function names are so strange here because this example was compiled as C++ 
and this is name mangling in C++, we will talk about it later: 3.21.1 on page 683. If 
we compile this in MSVC 2012, it uses the SIMD instructions for the FPU, read more 
about it here: 1.38.5 on page 554. 


ARM (ARM mode) 


Listing 1.360: Optimizing GCC 4.6.3 (IDA) 


float rand 


; RO=pseudorandom value 
FLDS 
; S0-1.0 
BIC 
BIC 
ORR 


SP!, {R3,LR} 
my rand 


S0, 


R3, 
R3, 
R3, 


=1.0 


RO, £O0xFF000000 
R3, #0x800000 
R3, #0x3F800000 


; R3=pseudorandom value & 0x007fffff | 0x3f800000 

; copy from R3 to FPU (register S15). 

; it behaves like bitwise copy, no conversion done: 
S15, R3 

; subtract 1.0 and leave result in SO: 


FMSR 


FSUBS 


S0, 


$15, S0 
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LDMFD — SP!, {R3,PC} 


flt 5C DCFS 1.0 
main 
STMFD SP!, {R4,LR} 
MOV RO, #0 
BL time 
BL my srand 
MOV RA, 40x64 ; 'd' 
loc 78 
BL float rand 
; SQ=pseudorandom value 
LDR RO, =aF ML hae 


; convert float type value into double type value (printf() will need it): 
FCVTDS D7, SO 

; bitwise copy from D7 into R2/R3 pair of registers (for printf()): 
FMRRD R2, R3, D7 


BL printf 
SUBS R4, R4, #1 
BNE loc 78 
MOV RO, R4 


LDMFD — SP!, {R4,PC} 


aF DCB "%f",0xA,0 


We'll also make a dump in objdump and we'll see that the FPU instructions have 
different names than in IDA. Apparently, IDA and binutils developers used different 
manuals? Perhaps it would be good to know both instruction name variants. 


Listing 1.361: Optimizing GCC 4.6.3 (objdump) 


00000038 «float rand»: 


38: e92d4008 push (r3, lr} 
3c: ebfffffe bl 10 «my rand» 
40: ed9f0a05 vldr s0, [pc, #20] ; 5c «float rand«0x24» 
44: e3c034ff bic r3, ro, #-16777216 ; Oxff000000 
48: e3c33502 bic r3, r3, 48388608 ; 0x800000 
4C: e38335fe orr r3, r3, 41065353216 ; 0x3f800000 
50: ee073a90 vmov s15, r3 

54: ee370ac0 vsub.f32 s0, s15, sO 

58: e8bd8008 pop {r3, pc} 

5c: 3f800000 SVCCC 0x00800000 

00000000 «main»: 

0: e92d4010 push (r4, lr} 

4: e3a00000 mov ro, #0 

8: ebfffffe bl 0 «time» 

c ebfffffe bl 0 «main» 

10: e3a04064 mov r4, #100 ; 0x64 

14: ebfffffe bl 38 <main+0x38> 

18: e59f0018 ldr rO, [pc, #24] ; 38 <main+0x38> 

1c: eeb77ac0 vcvt.f64.f32 d7, sO 
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20: ec532b17 vmov r2, r3, d7 

24: ebfffffe bl 0 <printf> 

28: e2544001 subs r4, r4, #1 

2c: lafffff8 bne 14 <main+0x14> 
30: ela00004 mov ro, r4 

34: e8bd8010 pop (r4, pc} 

38: 00000000 andeq roO, rO, ro 


The instructions at Ox5c in float rand() and at 0x38 in main() are (pseudo-)random 
noise. 


1.32.2 Calculating machine epsilon 


The machine epsilon is the smallest possible value the FPU can work with. The 
more bits allocated for floating point number, the smaller the machine epsilon. It is 
2773 x 1.19e - 07 for float and 2-°? x 2.22e - 16 for double. See also: Wikipedia article. 


It's interesting, how easy it's to calculate the machine epsilon: 


#include <stdio.h> 
#include <stdint.h> 


union uint float 


1 
uint32 t i; 
float f; 
$; 
float calculate machine epsilon(float start) 
1 
union uint float v; 
v.f=start; 
V.1++; 
return v.f-start; 
} 
void main() 
{ 
printf ("%g\n", calculate machine epsilon(1.0)); 
Hh 


What we do here is just treat the fraction part of the IEEE 754 number as integer and 
add 1 to it. The resulting floating number is equal to starting value + machine epsilon, 
so we just have to subtract the starting value (using floating point arithmetic) to 
measure, what difference one bit reflects in the single precision (float). The union 
serves here as a way to access IEEE 754 number as a regular integer. Adding 1 to it 
in fact adds 1 to the fraction part of the number, however, needless to say, overflow 
is possible, which will add another 1 to the exponent part. 


x86 
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Listing 1.362: Optimizing MSVC 2010 


tv130 = 8 
_v$ = 8 
_start$ = 8 
calculate machine epsilon PROC 
fld DWORD PTR start$[esp-4] 
; this instruction is redundant: 
fst DWORD PTR v$[esp-4] 
inc DWORD PTR v$[esp-4] 


fsubr DWORD PTR v$[esp-4] 
; this instruction pair is also redundant: 
fstp DWORD PTR tv130[esp-4] 
fld DWORD PTR tv130[esp-4] 
ret 0 
calculate machine epsilon ENDP 


The second FST instruction is redundant: there is no necessity to store the input 
value in the same place (the compiler decided to allocate the v variable at the same 
point in the local stack as the input argument). Then it is incremented with INC, as 
it is a normal integer variable. Then it is loaded into the FPU as a 32-bit IEEE 754 
number, FSUBR does the rest of job and the resulting value is stored in STO. The last 
FSTP/FLD instruction pair is redundant, but the compiler didn't optimize it out. 


ARM64 


Let's extend our example to 64-bit: 


#include <stdio.h> 
#include <stdint.h> 


typedef union 
uint64 t i; 
double d; 

} uint_double; 


double calculate machine epsilon(double start) 


{ 
uint_double v; 
v.d=start; 
v.itt+; 
return v.d-start; 
} 
void main() 
{ 
printf ("%g\n", calculate machine epsilon(1.0)); 
h 


ARM64 has no instruction that can add a number to a FPU D-register, so the input 
value (that came in DO) is first copied into GPR, incremented, copied to FPU register 
D1, and then subtraction occurs. 
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Listing 1.363: Optimizing GCC 4.9 ARM64 


calculate machine epsilon: 


fmov x0, dO ; load input value of double type into XO 
add x0, x0, 1 ; XO++ 

fmov dl, x0 ; move it to FPU register 

fsub dO, dl, dO ; subtract 

ret 


See also this example compiled for x64 with SIMD instructions: 1.38.4 on page 553. 


MIPS 


The new instruction here is MTC1 (“Move To Coprocessor 1"), it just transfers data 
from GPR to the FPU's registers. 


Listing 1.364: Optimizing GCC 4.4.5 (IDA) 


calculate machine epsilon: 
mfcl $v0, $f12 
or $at, $zero ; NOP 
addiu $v1, $v0, 1 
mtcl $v1, $f2 
jr $ra 
sub.s $f0, $f2, $f12 ; branch delay slot 


Conclusion 


It's hard to say whether someone may need this trickery in real-world code, but as 
was mentioned many times in this book, this example serves well for explaining the 
IEEE 754 format and unions in C/C++. 


1.32.3 FSCALE instruction replacement 


Agner Fog in his Optimizing subroutines in assembly language / An optimization 
guide for x86 platforms work 19? states that FSCALE FPU instruction (calculating 2”) 
may be slow on many CPUs, and he offers faster replacement. 


Here is my translation of his assembly code to C/C++: 


#include «stdint.h» 
#include <stdio.h> 


union uint float 

1 
uint32 t i; 
float f; 

y; 


float flt_2n(int N) 


163http://www.agner.org/optimize/optimizing assembly .pdf 
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1 
union uint float tmp; 
tmp .i=(N<<23)+0x3f800000; 
return tmp.f; 

$; 

struct float_as struct 

1 
unsigned int fraction : 23; 
unsigned int exponent : 8; 
unsigned int sign : 1; 

}; 

float flt 2n v2(int N) 

1 
struct float as struct tmp; 
tmp.fraction=0; 
tmp.sign=0; 
tmp .exponent=N+0x7f; 
return *(float*)(&tmp); 

$; 

union uint64 double 

1 
uint64 t i; 
double d; 

}; 

double dbl_2n(int N) 

{ 
union uint64 double tmp; 
tmp.i-((uint64 t)N««52)-«0x3ff0000000000000UL ; 
return tmp.d; 

}; 

struct double as struct 

1 
uint64 t fraction : 52; 
int exponent : 11; 
int sign : 1; 

}; 

double dbl 2n v2(int N) 

1 


struct double as struct tmp; 


tmp.fraction=0; 
tmp.sign=0; 

tmp .exponent=N+0x3ff; 
return *(double*) (&tmp) ; 
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y 

int main() 

{ 
// 2% = 2048 
printf ("%f\n", flt_2n(11)); 
printf ("%f\n", flt_2n_v2(11)); 
printf ("%lf\n", dbl 2n(11)); 
printf ("%lf\n", dbl 2n v2(11)); 


FSCALE instruction may be faster in your environment, but still, it’s a good example 
of union's and the fact that exponent is stored in 2” form, so an input n value is shifted 
to the exponent in IEEE 754 encoded number. Then exponent is then corrected with 
addition of 0x3f800000 or Ox3ff0000000000000. 


The same can be done without shift using struct, but internally, shift operations still 
occurred. 


1.32.4 Fast square root calculation 


Another well-known algorithm where float is interpreted as integer is fast calculation 
of square root. 


Listing 1.365: The source code is taken from Wikipedia: https://en.wikipedia. 
org/wiki/Methods of computing square roots 


/* Assumes that float is in the IEEE 754 single precision floating point 7 
y format 
* and that int is 32 bits. */ 
float sqrt approx(float z) 


1 
int val int = *(int*)&z; /* Same bits, but as an int */ 
/* 
* To justify the following code, prove that 
* 
* ((((val int / 27m) - b) / 2) + b) * 22m = ((val int - 27m) / 2) + ((2 
Gb+1) / 2) * 21m) 
* 
* where 
* 
* b = exponent bias 
* m - number of mantissa bits 
* 
* . 
*/ 
val int -= 1 << 23; /* Subtract 2^m. */ 
val int >>= 1; /* Divide by 2. */ 
val int += 1 << 29; /* Add ((b + 1) / 2) * 2^m. */ 
return *(float*)&val int; /* Interpret again as float */ 
} 
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As an exercise, you can try to compile this function and to understand, how it works. 


There is also well-known algorithm of fast calculation of Ta" Algorithm became pop- 


ular, supposedly, because it was used in Quake III Arena. 


Algorithm description can be found in Wikipedia: http://en.wikipedia.org/wiki/ 
Fast inverse square root. 


1.33 Pointers to functions 
A pointer to a function, as any other pointer, is just the address of the function's 
start in its code segment. 
They are often used for calling callback functions. 
Well-known examples are: 
e gsort(), atexit() from the standard C library; 
* *NIX OS signals. 
* thread starting: CreateThread() (win32), pthread create() (POSIX); 
* lots of win32 functions, like EnumChildWindows(). 


* lots of places in the Linux kernel, for example the filesystem driver functions 
are called via callbacks. 


* The GCC plugin functions are also called via callbacks. 


So, the qsort() function is an implementation of quicksort in the C/C++ standard 
library. The function is able to sort anything, any type of data, as long as you have 
a function to compare these two elements and qsort() is able to call it. 


The comparison function can be defined as: 


int (*compare)(const void *, const void *) 


Let's use the following example: 


/* ex3 Sorting ints with qsort */ 


#include <stdio.h> 
#include <stdlib.h> 


int comp(const void * a, const void * b) 
1 
const int *a-(const int *) a; 
const int *b-(const int *) b; 


if (*a==*b) 
return 0; 
else 
if (*a « *b) 
return -1; 
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else 
return 1; 
} 
int main(int argc, char* argv[]) 


{ 


int numbers[10]={1892, 45,200, -98,4087,5, -12345,1087, 88, -100000}; 


int i; 


/* Sort the array */ 
qsort(numbers,10,sizeof (int) ,comp) 
for (i=0;i<9; i++) 


, 


printf("Number = %d\n",numbers[ i ]) ; 


return 0; 


1.33.1 MSVC 


Let's compile it in MSVC 2010 (some parts were omitted for the sake of brevity) with 


/0x option 
Listing 1.366: Optimizing MSVC 2010: /GS- /MD 

. a$ = 8 ; size = 4 
_ b$ = 12 ; size = 4 
comp PROC 

mov eax, DWORD PTR  a$[esp-4] 

mov ecx, DWORD PTR  b$[esp-4] 

mov eax, DWORD PTR [eax] 

mov ecx, DWORD PTR [ecx] 

cmp eax, ecx 

jne SHORT $LN4@comp 

xor eax, eax 

ret 0 
$LN4@comp: 

xor edx, edx 

cmp eax, ecx 

setge dl 

lea eax, DWORD PTR [edx+edx-1] 

ret 0 
_comp ENDP 
_numbers$ = -40 ; size = 40 
_argc$ = 8 ; size = 4 
_argv$ = 12 ; size = 4 
_main PROC 

sub esp, 40 ; 00000028H 

push esi 

push OFFSET _comp 

push 4 

lea eax, DWORD PTR _numbers$[esp+52] 

push 10 ; 0000000aH 
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push eax 

mov DWORD PTR _numbers$[esp+60], 1892 ; 00000764H 
mov DWORD PTR _numbers$[esp+64], 45 ; 0000002dH 
mov DWORD PTR _numbers$[esp+68], 200 ; 000000c8H 
mov DWORD PTR _numbers$[esp+72], -98 ; ffffff9eH 
mov DWORD PTR _numbers$[esp+76], 4087 ; 00000ff7H 
mov DWORD PTR _numbers$[esp+80], 5 

mov DWORD PTR _numbers$[esp+84], -12345 ; ffffcfc7H 
mov DWORD PTR _numbers$[esp+88], 1087 ; 0000043fH 
mov DWORD PTR _numbers$[esp+92], 88 ; 00000058H 
mov DWORD PTR _numbers$[esp+96], -100000 ; fffe7960H 
call _qsort 

add esp, 16 ; 00000010H 


Nothing surprising so far. As a fourth argument, the address of label comp is passed, 
which is just a place where comp () is located, or, in other words, the address of the 
very first instruction of that function. 


How does qsort() call it? 


Let's take a look at this function, located in MSVCR80.DLL (a MSVC DLL module with 
C standard library functions): 


Listing 1.367: MSVCR80.DLL 


.text:7816CBFO ; void cdecl qsort(void *, unsigned int, unsigned int, int 
( cdecl *)(const void *, const void *)) 

. text: 7816CBFO public _qsort 

.text:7816CBFO qsort proc near 

. text: 7816CBFO 

.text:7816CBFO lo 

.text:7816CBFO hi 

.text:7816CBFO var FC 

.text:7816CBF0 stkptr 

.text:7816CBFO lostk 

.text:7816CBFO histk 

. text: 7816CBFO base 

.text:7816CBFO num 

. text: 7816CBFO width 

.text:7816CBFO comp 

. text: 7816CBFO 


dword ptr -104h 
dword ptr -100h 
dword ptr -OFCh 
dword ptr -OF8h 
dword ptr -0F4h 
dword ptr -7Ch 
dword ptr 4 

dword ptr 8 

dword ptr Ch 
dword ptr 10h 


.text:7816CBF0 sub esp, 100h 

.text:7816CCEO loc 7816CCE0: ; CODE XREF: _qsort+Bl 
.text:7816CCEO0 shr eax, 1 

.text:7816CCE2 imul eax, ebp 

.text:7816CCE5 add eax, ebx 

.text:7816CCE7 mov edi, eax 

.text:7816CCE9 push edi 

.text:7816CCEA push ebx 

.text:7816CCEB call [esp+118h+comp] 
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.text:7816CCF2 add esp, 8 
.text:7816CCF5 test eax, eax 
.text:7816CCF7 jte short loc 7816CD04 


comp—is the fourth function argument. Here the control gets passed to the address 
in the comp argument. Before it, two arguments are prepared for comp(). Its result 
is checked after its execution. 


That's why it is dangerous to use pointers to functions. First of all, if you call qsort() 
with an incorrect function pointer, qsort() may pass control flow to an incorrect 
point, the process may crash and this bug will be hard to find. 


The second reason is that the callback function types must comply strictly, calling the 
wrong function with wrong arguments of wrong types may lead to serious problems, 
however, the crashing of the process is not a problem here —the problem is how to 
determine the reason for the crash —because the compiler may be silent about the 
potential problems while compiling. 
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MSVC + OllyDbg 


Let's load our example into OllyDbg and set a breakpoint on comp(). We can see 
how the values are compared at the first comp() call: 


884424 04 MOU EAX, DWORD PTR SS:IHRG.17 Cal i ) 
8B4C24 88 — [MOV ECX DWORD PTR SS:LHRG.21 e Prestan f 
MOU EAX, DWORD PTR DS: LEAX] E 
MOU ECX, DWORD PTR DS: CECKI E 
CHP EAX, ECX bro] 
JNE SHORT QAFD1613 eee 


^ BBS7FEIS 
9637FEDC 
9637FEBS 


BOFD1BOC 17_1.G6FD109C 


ES 462 at FFFFFFFF) 

) at FFFFFFFF) 
acFFFFFFFF) 
atcFFFFFFFF) 
7EFODGG6( FFF) 
G(FFFFFFFF) 


RETN 
XOR EDX, EDX 
CMP EAX,ECK 


SETGE DL 
LER EAX, LEDX*EDX-11 
RETN 
INTS 
SUB ESP, 2C 
€ H ORD PTR 


vee 

m OM 
DD Das 
c 


De 


6 a 


SO4ONDVO m mnmmmm 


me 
m 
pa 


aa oa ao 
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Figure 1.109: OllyDbg: first call of comp() 


OllyDbg shows the compared values in the window under the code window, for con- 
venience. We can also see that the SP points to RA, where the qsort() function is 
(located in MSVCR100.DLL). 
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By tracing (F8) until the RETN instruction and pressing F8 one more time, we return 
to the qsort() function: 


CPU - main thread, module MSVCR100 


JMP SHORT 6ESF4RCF 
SHR EAX, 1 
IMUL EBX, EAX 
ADD EBX, EDI 
ISH EBX 


> 
TEST ERX,ERX 

JLE SHORT 6ESF4B53 

MOV EDX, DWORD PTR SS: [EBP+10] 
MOU EAX, EBX 

CMP EDI,EBX 

JE SHORT 6ESF4B53 

MOV ECX,EDI 


88. 6E3F4B20 

> B(FFFFFFFF) 
BLFFFFFFFF) 

t B(FFFFFFFF) 

: B(FFFFFFFF) 
7EFDDaaBtFFF) 
at FFFFFFFF) 


Figure 1.110: OllyDbg: the code in qsort() right after comp() call 


That has been a call to the comparison function. 
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Here is also a screenshot of the moment of the second call of comp() —now values 
that have to be compared are different: 


CPU - main thread, module 17 1 


5 SB4424 84 MOU EAX,DWORD PTR SS: CARG. 1] 
* S8B4C24 88 MOU ECX, DWORD PTR SS: CARG.2] 
MOU EAX, DWORD PTR DS: CEAXI 
ue ECX, DWORD PTR DS: [ECX] 

* 
JNE SHORT 60FD1613 
XOR EAX, EAX 


RETN 

XOR EDX, EDX 

CMP_EAX, ECX 

SETGE DL 

LEA EAX, LEDX*EDX-11 

RETI C @( FFFFFFFF) 
3 na s Bt FFFFFFFF) 

SUB ESP,2C rn cEnadin Ot FFFFFFFF) 

ED EB OO Tel $8 7EFDDaaatFFF) 


BtFFFFFFFF) 


aa aa ao 00 HA aO 


Figure 1.111: OllyDbg: second call of comp() 


MSVC + tracer 


Let's also see which pairs are compared. These 10 numbers are being sorted: 1892, 
45, 200, -98, 4087, 5, -12345, 1087, 88, -100000. 


We got the address of the first CMP instruction in comp (), it is 0x0040100C and we've 
set a breakpoint on it: 


tracer.exe -1:17 l.exe bpx-17 1.exe!0x0040100C 


Now we get some information about the registers at the breakpoint: 


PID-4336|New process 17 1.exe 

(0) 17 1.exe!0x40100c 

EAX-0x00000764 EBX-0x0051f7c8 ECX=0x00000005 EDX-0x00000000 
ESI-0x0051f7d8 EDI=0x0051f7b4 EBP=0x0051f794 ESP=0x0051f67c 
EIP=0x0028100c 

FLAGS=IF 

(0) 17 1.exe!0x40100c 

EAX=0x00000005 EBX-0x0051f7c8 ECX=0xfffe7960 EDX=0x00000000 
ESI-0x0051f7d8 EDI=0x0051f7b4 EBP=0x0051f794 ESP=0x0051f67c 
EIP=0x0028100c 

FLAGS=PF ZF IF 

(0) 17 1.exe!0x40100c 

EAX-0x00000764 EBX-0x0051f7c8 ECX=0x00000005 EDX-0x00000000 
ESI-0x0051f7d8 EDI=0x0051f7b4 EBP=0x0051f794 ESP=0x0051f67c 
EIP=0x0028100c 

FLAGS=CF PF ZF IF 
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EAX=0x00000764 
EAX=0x00000005 
EAX=0x00000764 
EAX=0x0000002d 
EAX=0x00000058 
EAX=0x0000043 Ff 
EAX=0xffffcfc7 
EAX=0x000000c8 
EAX-Oxffffff9e 
EAX=0x00000ff7 
EAX=0x00000ff7 
EAX-Oxffffff9e 
EAX-Oxffffff9e 
EAX=0xffffcfc7 
EAX=0x00000005 
EAX=0xffffff9e 
EAX-Oxffffcfc7 
EAX-Oxffffff9e 
EAX=0xffffcfc7 
EAX=0x000000c8 
EAX=0x0000002d 
EAX-0x0000043f 
EAX=0x00000058 
EAX=0x00000764 
EAX=0x000000c8 
EAX=0x0000002d 
EAX=0x0000043 Ff 
EAX=0x00000058 
EAX=0x000000c8 
EAX=0x0000002d 
EAX=0x0000043f 
EAX=0x000000c8 
EAX=0x0000002d 
EAX=0x0000002d 


ECX=0x00000005 
ECX=0xfffe7960 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0x00000005 
ECX=0xfffe7960 
ECX=0xffffcfc7 
ECX=0x00000005 
ECX=0xfffe7960 
ECX=0xffffcfc7 
ECX=0xfffe7960 
ECX=0x00000ff7 
ECX=0x00000ff7 
ECX=0x00000ff7 
ECX=0x00000ff7 
ECX=0x00000ff7 
ECX=0x00000764 
ECX=0x00000764 
ECX=0x00000764 
ECX=0x00000764 
ECX=0x00000058 
ECX=0x000000c8 
ECX=0x000000c8 
ECX=0x00000058 
ECX=0x000000c8 
ECX=0x00000058 


That’s 34 pairs. Therefore, the quick sort algorithm needs 34 comparison operations 


to sort these 10 numbers. 
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MSVC + tracer (code coverage) 


We can also use the tracer's feature to collect all possible register values and show 
them in IDA. 


Let's trace all instructions in comp(): 


tracer.exe -1:17 1.exe bpf-17 1.exe!0x00401000,trace:cc 


We get an .idc-script for loading into IDA and load it: 


. text : 66461666 
-text:60461606 ; int — cdecl PtFuncCompare(const void *, const void x) 
-text: 60461666 PtFuncCompare proc near ; DATA XREF:  main*5|o 


-text : 66461666 
-text : 66461666 
- text : 66401666 
- text : 66461666 


arg 8 
arg ^ 


= dword ptr 4 
= dword ptr 8 


-text : 66461666 nou eax, [esp*arg 8] ; [ESP+4]=0x45f7ec..0x45f810(step=4), L'?1x047 
-text : 60461064 mou ecx, [esp*arg ^] ; [ESP*8]-8xh5f7ec..8xh5f7fh(step-h), Ox45F7 FC 
-text:80481808 mou eax, [eax] ; [EAX]=5, Ox2d, 0x58, Oxc8, 0x43f, 0x764, OxFf 
-text:880481886n mou ecx, [ecx] ; [ECX]-5, 0x58, Gxc8, 0x764, Oxff7, Oxfffe7968 
-text : 60461 66C cmp eax, ecx ; EAX=5, Ox2d, 0x58, Oxc8, Ox43F, 0x764, Oxff7, 
-text : 60461 06E jnz short loc_461613 ; 2F-false 

.text:80401018 xor eax, eax 

-text:80481012 retn 

.text:80481013 ; --------—— a: 

-text :00401013 

.text:00401013 loc_461613: ; CODE XREF: PtFuncCompare+E?j 

-text:80581013 xor edx, edx 

.text:00401015 cnp eax, ecx ; EAX=5, Ox2d, 0x58, Oxc8, Oxh3f, 0x764, Oxff7, 
.text:00401017 setnl dl ; SF=false,true OF=false 

-text :6046161A lea eax, [edx+edx-1] 

-text :6046161E retn ; EAX=1, OxffFFFFFF 

.text:0048101E PtFuncCompare  endp 


-text :AALAIAIF 


Figure 1.112: tracer and IDA. N.B.: some values are cut at right 


IDA gave the function a name (PtFuncCompare)—because IDA sees that the pointer 
to this function is passed to qsort(). 


We see that the a and b pointers are pointing to various places in the array, but the 
step between them is 4, as 32-bit values are stored in the array. 


We see that the instructions at 0x401010 and 0x401012 were never executed (so 
they left as white): indeed, comp() has never returned 0, because there no equal 
elements in the array. 


1.33.2 GCC 
Not a big difference: 
Listing 1.368: GCC 


lea eax, [esp+40h+var_ 28] 
mov [esp+40h+var_40], eax 
mov [esp+40h+var_ 28], 764h 
mov [esp+40h+var 24], 2Dh 
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mov [esp-40h-var 20], 0C8h 
mov [esp-40h-var 1C], OFFFFFF9Eh 
mov [esp-40h-var 18], OFF7h 
mov [esp+40h+var_ 14], 5 
mov [esp-40h-var 10], OFFFFCFC7h 
mov [esp-40h-var C], 43Fh 
mov [esp-40h-var 8], 58h 
mov [esp-40h-var 4], OFFFE7960h 
mov [esp-40h-var 34], offset comp 
mov [esp+40h+var 38], 4 
mov [esp-40h-var 3C], 0Ah 
call _qsort 
comp () function: 
public comp 
comp proc near 
arg_0 = dword ptr 8 
arg_4 = dword ptr  OCh 
push ebp 
mov ebp, esp 
mov eax, [ebp+arg_4] 
mov ecx, [ebp+arg_0] 
mov edx, [eax] 
xor eax, eax 
cmp [ecx], edx 
jnz short loc 8048458 
pop ebp 
retn 
loc 8048458: 
setnl al 
movzx  eax, al 
lea eax, [eax+eax-1] 
pop ebp 
retn 
comp endp 


The implementation of qsort() islocated in Libc.so.6 and itis in fact just a wrapper 


164 for asort r(). 


In turn, it is calling quicksort(), where our defined function is called via a passed 


pointer: 


Listing 1.369: (file libc.so.6, glibc version—2.10.1) 


. text: 0002DDF6 
. text: 0002DDF9 
. text: 0002DDFD 
. text: 0002DE00 


mov edx, [ebp+arg 10] 
mov [esp+4], esi 

mov [esp], edi 

mov [esp+8], edx 


1643 concept like thunk function 
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.text:0002DE04 call [ebp*arg C] 


GCC + GDB (with source code) 


Obviously, we have the C-source code of our example (1.33 on page 483), so we can 
set a breakpoint (b) on line number (11—the line where the first comparison occurs). 
We also have to compile the example with debugging information included (-g), so 
the table with addresses and corresponding line numbers is present. 


We can also print values using variable names (p): the debugging information also 
has tells us which register and/or local stack element contains which variable. 


We can also see the stack (bt) and find out that there is some intermediate function 
msort_with_tmp() used in Glibc. 


Listing 1.370: GDB session 


dennis@ubuntuvm:~/polygon$ gcc 17 1.c -g 
dennis@ubuntuvm:~/polygon$ gdb ./a.out 

GNU gdb (GDB) 7.6.1-ubuntu 

Copyright (C) 2013 Free Software Foundation, Inc. 


Reading symbols from /home/dennis/polygon/a.out...done. 
(gdb) b 17 1.c:11 

Breakpoint 1 at 0x804845f: file 17 1.c, line 11. 

(gdb) run 

Starting program: /home/dennis/polygon/./a.out 


Breakpoint 1, comp (_a=0xbffff0f8, b= bgentry-OxbffffOfc) at 17 1.c:11 
11 if (*a==*b) 


(gdb) c 
Continuing. 


Breakpoint 1, comp (_a=0xbffff104, b= b@entry=Oxbffff108) at 17 1.c:11 
11 if (*a==*b) 


(gdb) bt 

#0 comp ( a-OxbffffOf8, b= bgentry-OxbffffOfc) at 17 1.c:11 

#1 0xb7e42872 in msort with tmp (p=pGentry=0xbffff07c, b=b@entry=0 7 
V xbffffOf8, n=n@entry=2) 
at msort.c:65 

#2  0xb7e4273e in msort with tmp (n=2, b=0xbffff0f8, p=0xbffff07c) at msortyv 
G .C:45 

#3 msort with tmp (p=pGentry=0xbffff07c, b-bgentry-OxbffffOf8, n=n@entry z7 
Y =5) at msort.c:53 
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#4  0xb7e4273e in msort with tmp (n=5, b=0xbffff0f8, p=0xbffff07c) at msorty 
Y .c:45 

#5 msort with tmp (p=pGentry=0xbffff07c, b-bgentry-OxbffffOf8, n=n@entry 
V =10) at msort.c:53 

#6  0xb7e42cef in msort with tmp (n=10, b=0xbffff0f8, p=0xbffff07c) at 2 
G msort.c:45 

37 GI qsort_r (b-bgentry-OxbffffOf8, n=n@entry=10, s=s@entry=4, cmp-2 
V cmp@ent ry=0x804844d «comp», 
arg=arg@entry=0x0) at msort.c:297 

#8 Oxb7e42dcf in GI qsort (b=0xbffff0f8, n-10, s-4, cmp=0x804844d «comp; 
S >) at msort.c:307 

#9  0x0804850d in main (argc=1, argv=0xbffff1c4) at 17 1.c:26 

(gdb) 


GCC + GDB (no source code) 


But often there is no source code at all, so we can disassemble the comp() function 
(disas), find the very first CMP instruction and set a breakpoint (b) at that address. 


At each breakpoint, we are going to dump all register contents 
(info registers). The stack information is also available (bt), 


but partially: there is no line number information for comp( ). 


Listing 1.371: GDB session 


dennis@ubuntuvm:~/polygon$ gcc 17 1.c 
dennis@ubuntuvm:~/polygon$ gdb ./a.out 

GNU gdb (GDB) 7.6.1-ubuntu 

Copyright (C) 2013 Free Software Foundation, Inc. 


Reading symbols from /home/dennis/polygon/a.out...(no debugging symbols 2 
S found)...done. 

(gdb) set disassembly-flavor intel 

(gdb) disas comp 

Dump of assembler code for function comp: 


0x0804844d «40»: push ebp 

0x0804844e <+1>: mov ebp,esp 

0x08048450 «43»: sub esp, 0x10 

0x08048453 «46»: mov eax,DWORD PTR [ebp+0x8] 
0x08048456 <+9>: mov DWORD PTR [ebp-0x8],eax 
0x08048459 <+12>: mov eax,DWORD PTR [ebp+0xc] 
0x0804845c <+15>: mov DWORD PTR [ebp-0x4],eax 
0x0804845f <+18>: mov eax,DWORD PTR [ebp-0x8] 
0x08048462 <+21>: mov edx,DWORD PTR [eax] 
0x08048464 <+23>: mov eax,DWORD PTR [ebp-0x4] 
0x08048467 <+26>: mov eax,DWORD PTR [eax] 
0x08048469 <+28>: cmp edx,eax 

0x0804846b «430»: jne 0x8048474 <comp+39> 
0x0804846d «432»: mov eax,0x0 

0x08048472 «437»: jmp 0x804848e <comp+65> 
0x08048474 «439»: mov eax,DWORD PTR [ebp-0x8] 
0x08048477 «442»: mov edx,DWORD PTR [eax] 
0x08048479 «444»: mov eax,DWORD PTR [ebp-0x4] 
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0x0804847c «447»: mov 
0x0804847e «449»: cmp 
0x08048480 «4-51»: jge 
0x08048482 «453»: mov 
0x08048487 «458»: jmp 
0x08048489 «460»: mov 
0x0804848e «465»: leave 
0x0804848f «466»: ret 


End of assembler dump. 


(gdb) b *0x08048469 


Breakpoint 1 at 0x8048469 


(gdb) run 


eax,DWORD PTR [eax] 
edx,eax 

0x8048489 <comp+60> 
eax,0xffffffff 
0x804848e <comp+65> 
eax,0x1 


Starting program: /home/dennis/polygon/./a.out 


Breakpoint 1, 0x08048469 in comp () 


(gdb) info registers 


eax 0x2d 45 

ecx OxbffffOf8 -1073745672 
edx 0x764 1892 

ebx Oxb7 fc0000 - 1208221696 
esp Oxbfffeeb8 Oxbfffeeb8 
ebp Oxbfffeec8 Oxbfffeec8 
esi OxbffffOfc -1073745668 
edi Oxbffff010 -1073745904 
eip 0x8048469 0x8048469 <comp+28> 
eflags 0x286 [ PF SF IF ] 

cs 0x73 115 

SS 0x7b 123 

ds Ox7b 123 

es 0x7b 123 

fs 0x0 0 

gs 0x33 51 

(gdb) c 

Continuing. 


Breakpoint 1, 0x08048469 in comp () 


(gdb) info registers 


eax Oxff7 4087 

ecx Oxbffff104 -1073745660 
edx Oxffffff9e -98 

ebx Oxb7 fc0000 - 1208221696 
esp Oxbfffee58 Oxbfffee58 
ebp Oxbfffee68 Oxbfffee68 
esi Oxbffff108 -1073745656 
edi OxbffffO10 -1073745904 
eip 0x8048469 0x8048469 <comp+28> 
eflags 0x282 [ SF IF ] 

cs 0x73 115 

SS 0x7b 123 

ds 0x7b 123 

es 0x7b 123 

fs 0x0 0 

gs 0x33 51 
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(gdb) c 
Continuing. 


Breakpoint 1, 0x08048469 in comp () 
(gdb) info registers 


eax Oxffffff9e -98 

ecx Oxbffff100 -1073745664 
edx Oxc8 200 

ebx Oxb7 fc0000 - 1208221696 
esp Oxbfffeeb8 Oxbfffeeb8 
ebp Oxbfffeec8 Oxbfffeec8 
esi Oxbffff104 -1073745660 
edi Oxbffff010 -1073745904 
eip 0x8048469 0x8048469 <comp+28> 
eflags 0x286 [ PF SF IF ] 

cs 0x73 115 

SS 0x7b 123 

ds 0x7b 123 

es 0x7b 123 

fs 0x0 0 

gs 0x33 51 

(gdb) bt 


#0 0x08048469 in comp () 

#1 0xb7e42872 in msort with tmp (p=pGentry=0xbffff07c, b=b@entry=0 7 
V xbffffOf8, n=n@entry=2) 
at msort.c:65 

32  0xb7e4273e in msort with tmp (n=2, b=0xbffff0f8, p=0xbffff07c) at msortv 
Y .c:45 

#3 msort with tmp (p=pGentry=0xbffff07c, b-bgentry-OxbffffOf8, n=nfentry 7 
Y =5) at msort.c:53 

#4  0xb7e4273e in msort with tmp (n=5, b=0xbffff0f8, p=0xbffff07c) at msorty 
V .c:45 

#5 msort with tmp (p=pGentry=0xbffff07c, b-bgentry-OxbffffOf8, n=nfentry 
S -10) at msort.c:53 

#6  0xb7e42cef in msort with tmp (n=10, b=0xbffff0f8, p=0xbffff07c) at 7 
G msort.c:45 

37 GI qsort_r (b-bgentry-OxbffffOf8, n=n@entry=10, s=s@entry=4, cmp=2 
V cmp@ent ry=0x804844d «comp», 
arg=arg@entry=0x0) at msort.c:297 

#8 Oxb7e42dcf in GI qsort (b=0xbffff0f8, n-10, s-4, cmp=0x804844d «comp; 
S >) at msort.c:307 

#9  0x0804850d in main () 


1.33.3 Danger of pointers to functions 


As we can see, qsort() function expects a pointer to function which takes two void* 
arguments and returning integer. If you have several comparison functions in your 
code (one compares string, another—integers, etc), it's very easy to mix them up 
with each other. You could try to sort array of string using function which compares 
integers, and compiler will not warn you about bug. 
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1.34 64-bit values in 32-bit environment 


In a 32-bit environment, GPR's are 32-bit, so 64-bit values are stored and passed as 
32-bit value pairs 195. 


1.34.1 Returning of 64-bit value 


#include «stdint.h» 


uint64 t f () 
1 


return 0x1234567890ABCDEF ; 


x86 


In a 32-bit environment, 64-bit values are returned from functions in the EDX:EAX 
register pair. 


Listing 1.372: Optimizing MSVC 2010 


f PROC 
mov eax, -1867788817 ; 90abcdefH 
mov edx, 305419896 ; 12345678H 
ret 0 

f ENDP 

ARM 


A 64-bit value is returned in the RO-R1 register pair (R1 is for the high part and RO for 
the low part): 


Listing 1.373: Optimizing Keil 6/2013 (ARM mode) 


||] | PROC 
LDR r0,|L0.12| 
LDR r1,|LO.16| 
BX lr 
ENDP 
[L0.12| 
DCD 0x90abcdef 
[L0.16| 
DCD 0x12345678 


165By the way, 32-bit values are passed as pairs in 16-bit environment in the same way: 3.34.4 on 
page 824 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


498 


MIPS 


A 64-bit value is returned in the VO-V1 ($2-$3) register pair (VO ($2) is for the high 
part and V1 ($3) for the low part): 


Listing 1.374: Optimizing GCC 4.4.5 (assembly listing) 


li $3,-1867841536 # Oxffffffff90ab0000 
li $2,305397760 # 0x12340000 

ori $3,$3,0xcdef 

j $31 

ori $2,$2,0x5678 


Listing 1.375: Optimizing GCC 4.4.5 (IDA) 


lui $v1, Ox90AB 

lui $v0, 0x1234 

li $v1, Ox90ABCDEF 
jr $ra 

li $v0, 0x12345678 


1.34.2 Arguments passing, addition, subtraction 


#include <stdint.h> 


uint64 t f add (uint64 t a, uint64 t b) 
{ 


ur 


return a+b; 


void f add test () 


1 
#ifdef — GNUC - 
printf ("%lld\n", f add(12345678901234, 23456789012345)); 


#else 

printf ("%I64d\n", f add(12345678901234, 23456789012345)); 
Hendif 
$; 
uint64 t f sub (uint64 t a, uint64 t b) 
1 

return a-b; 
$; 
x86 

Listing 1.376: Optimizing MSVC 2012 /Ob1 

a$= 8 ; size = 8 
_b$ = 16 ; size = 8 
f add PROC 

mov eax, DWORD PTR  a$[esp-4] 
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add eax, DWORD PTR b$[esp-4] 
mov edx, DWORD PTR a$[esp] 
adc edx, DWORD PTR _b$[esp] 
ret 0 

f add ENDP 

f add test PROC 
push 5461 ; 00001555H 
push 1972608889 ; 75939f79H 
push 2874 ; 00000b3aH 
push 1942892530 ; 73ce2ff2H 
call f add 
push edx 
push eax 
push OFFSET $5G1436 ; '%164d', OaH, 00H 
call _printf 
add esp, 28 
ret 0 


f add test ENDP 


f sub PROC 
mov eax, DWORD PTR _a$[esp-4] 
sub eax, DWORD PTR _b$[esp-4] 
mov edx, DWORD PTR _a$[esp] 
sbb edx, DWORD PTR _b$[esp] 
ret 0 

f sub ENDP 


We can see inthe f add test() function that each 64-bit value is passed using two 
32-bit values, high part first, then low part. 


Addition and subtraction occur in pairs as well. 


In addition, the low 32-bit part are added first. If carry has been occurred while 
adding, the CF flag is set. 


The following ADC instruction adds the high parts of the values, and also adds 1 if 
CF —]1. 


Subtraction also occurs in pairs. The first SUB may also turn on the CF flag, which 
is to be checked in the subsequent SBB instruction: if the carry flag is on, then 1 is 
also to be subtracted from the result. 


It is easy to see how the f add() function result is then passed to printf(). 


Listing 1.377: GCC 4.8.1 -O1 -fno-inline 


f add: 
mov eax, DWORD PTR [esp+12] 
mov edx, DWORD PTR [esp+16] 
add eax, DWORD PTR [esp+4] 
adc edx, DWORD PTR [esp+8] 
ret 

f add test: 
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sub 
mov 
mov 
mov 
mov 
call 
mov 
mov 
mov 
call 
add 
ret 


f sub: 
mov 
mov 
sub 
sbb 
ret 


esp, 28 


DWORD PTR [esp+8], 1972608889 


DWORD PTR [esp+12], 5461 


DWORD PTR [esp], 1942892530 


DWORD PTR [esp+4], 2874 


f add 


DWORD PTR [esp+4], eax 
DWORD PTR [esp+8], edx 


DWORD PTR [esp], OFFSET FLAT:LCO ; 


_ printf 
esp, 28 


eax, DWORD PTR [esp+4] 
edx, DWORD PTR [esp+8] 
eax, DWORD PTR [esp+12] 
edx, DWORD PTR [esp+16] 


75939f79H 
00001555H 
73ce2ff2H 
00000b3aH 


"%lld\n" 


GCC code is the same. 


ARM 
Listing 1.378: Optimizing Keil 6/2013 (ARM mode) 
f_add PROC 
ADDS r0,r0,r2 
ADC rl,r1,r3 
BX lr 
ENDP 
f sub PROC 
SUBS r0,r0,r2 
SBC rl,r1,r3 
BX lr 
ENDP 
f_add_test PROC 
PUSH {r4, lr} 
LDR r2,|L0.68| ; 0x75939f79 
LDR r3,|L0.72| ; 0x00001555 
LDR r0,|L0.76| ; 0x73ce2ff2 
LDR r1,|L0.80| ; 0x00000b3a 
BL f add 
POP {r4, 1r} 
MOV r2,r0 
MOV r3,r1 
ADR r0,|L0.84| ; "*164d^n" 
B _ 2printf 
ENDP 


|LO.68 | 
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DCD 0x75939f79 
[L0.72| 

DCD 0x00001555 
[L0.76| 

DCD 0x73ce2f f2 
[L0.80| 

DCD 0x00000b3a 
[L0.84| 

DCB "%ST64d\n",0 


The first 64-bit value is passed in RO and R1 register pair, the second in R2 and R3 
register pair. ARM has the ADC instruction as well (which counts carry flag) and SBC 
("subtract with carry"). Important thing: when the low parts are added/subtracted, 
ADDS and SUBS instructions with -S suffix are used. The -S suffix stands for "set flags", 
and flags (esp. carry flag) is what consequent ADC/SBC instructions definitely need. 
Otherwise, instructions without the -S suffix would do the job (ADD and SUB). 


MIPS 


Listing 1.379: Optimizing GCC 4.4.5 (IDA) 


f add: 
; $a0 - high part of a 
; $al - low part of a 
; $a2 - high part of b 
; $a3 - low part of b 
addu $vl, $a3, $al ; sum up low parts 
addu $a0, $a2, $a0 ; sum up high parts 
; will carry generated while summing up low parts? 
; if yes, set $v0 to 1 
sltu $vO, $vl, $a3 
jr $ra 
; add 1 to high part of result if carry should be generated: 
addu $v0, $a0 ; branch delay slot 
; $v0 - high part of result 
; $v1 - low part of result 


f sub: 
; $a0 - high part of a 
; $al - low part of a 
; $a2 - high part of b 
; $a3 - low part of b 
subu $vl, fal, $a3 ; subtract low parts 
subu $v0, $a0, $a2 ; subtract high parts 
; will carry generated while subtracting low parts? 
; if yes, set $a0 to 1 
sltu $al, $v1 
jr $ra 
; subtract 1 from high part of result if carry should be generated: 
subu $v0, $al ; branch delay slot 
; $v0 - high part of result 
; $v1 - low part of result 
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(  gnu local gp >> 16) 
-0x20 

(__ gnu local gp € OxFFFF) 
0x20+var_4($sp) 
0x20+var_10($sp) 

0x73CE 

0x7593 

OxB3A 

0x75939F79 

0x1555 


0x73CE2FF2 
0x20+var_10($sp) 

($LCO >> 16) "%lld\n" 
(printf € OxFFFF) ($gp) 
0x20+var_4($sp) 
($LCO € OXFFFF) 
$v1 

$v0 


"%lld\n" 


0x20 


f add test: 

var 10 = -0x10 

var 4 = -4 
lui $9p, 
addiu  $sp, 
la $9p, 
SW $ra, 
Sw $9p, 
lui $al, 
lui $a3, 
li $a0, 
li $a3, 
li $a2, 
jal f_add 
li $al, 
lw $9p, 
lui $a0, 
lw $t9, 
lw $ra, 
la $a0, 
move $a3, 
move $a2, 
jr $t9 
addiu $sp, 

$LCO: „ascii "slldin"<0> 


MIPS has no flags register, so there is no such information present after the execution 
of arithmetic operations. So there are no instructions like x86's ADC and SBB. To know 
if the carry flag would be set, a comparison (using SLTU instruction) also occurs, 
which sets the destination register to 1 or 0. This 1 or 0 is then added or subtracted 


to/from the final result. 


1.34.3 Multiplication, division 


#include <stdint.h> 


uint64 t f mul (uint64 t a, uint64 t b) 


1 

return a*b; 
Fi 
uint64 t f_div 
{ 

return a/b; 
Fi 


(uint64 t a, uint64 t b) 


uint64 t f_rem (uint64 t a, uint64 t b) 


{ 


return a % b; 
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PE 


x86 


Listing 1.380: Optimizing MSVC 2013 /Ob1 


a$= 8 ; size = 8 


b$ = 16 ; size = 8 


_a$ = 8 ; size = 8 
b$ = 16 ; size = 8 


_f mul PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR _b$[ebp+4] 
push eax 
mov ecx, DWORD PTR _b$[ebp] 
push ecx 
mov edx, DWORD PTR _a$[ebp+4] 
push edx 
mov eax, DWORD PTR _a$[ebp] 
push eax 
call . allmul ; long long multiplication 
pop ebp 
ret 0 

f mul ENDP 


f div PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR _b$[ebp+4] 
push eax 
mov ecx, DWORD PTR _b$[ebp] 
push ecx 
mov edx, DWORD PTR _a$[ebp+4] 
push edx 
mov eax, DWORD PTR _a$[ebp] 
push eax 
call . aulldiv ; unsigned long long division 
pop ebp 
ret 0 

f div ENDP 

_a$ = 8 ; size = 8 

_b$ = 16 ; size = 8 

f rem PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR _b$[ebp+4] 
push eax 
mov ecx, DWORD PTR _b$[ebp] 
push ecx 
mov edx, DWORD PTR _a$[ebp+4] 
push edx 
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mov eax, DWORD PTR a$[ebp] 
push eax 
call . aullrem ; unsigned long long remainder 
pop ebp 
ret 0 
f rem ENDP 


Multiplication and division are more complex operations, so usually the compiler 
embeds calls to a library functions doing that. 


These functions are described here: .5 on page 1320. 


Listing 1.381: Optimizing GCC 4.8.1 -fno-inline 


f mul: 
push ebx 
mov edx, DWORD PTR [esp+8] 
mov eax, DWORD PTR [esp+16] 
mov ebx, DWORD PTR [esp+12] 
mov ecx, DWORD PTR [esp+20] 
imul ebx, eax 
imul ecx, edx 
mul edx 
add ecx, ebx 
add edx, ecx 
pop ebx 
ret 

_f div: 
sub esp, 28 
mov eax, DWORD PTR [esp+40] 
mov edx, DWORD PTR [esp+44] 
mov DWORD PTR [esp+8], eax 
mov eax, DWORD PTR [esp+32] 
mov DWORD PTR [esp+12], edx 
mov edx, DWORD PTR [esp+36] 
mov DWORD PTR [esp], eax 
mov DWORD PTR [esp+4], edx 
call ___udivdi3 ; unsigned division 
add esp, 28 
ret 

_f rem: 
sub esp, 28 
mov eax, DWORD PTR [esp+40] 
mov edx, DWORD PTR [esp+44] 
mov DWORD PTR [esp+8], eax 
mov eax, DWORD PTR [esp+32] 
mov DWORD PTR [esp+12], edx 
mov edx, DWORD PTR [esp+36] 
mov DWORD PTR [esp], eax 
mov DWORD PTR [esp+4], edx 
call ___umoddi3 ; unsigned modulo 
add esp, 28 
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ret 


GCC does the expected, but the multiplication code is inlined right in the function, 
thinking it could be more efficient. GCC has different library function names: .4 on 
page 1320. 

ARM 


Keil for Thumb mode inserts library subroutine calls: 


Listing 1.382: Optimizing Keil 6/2013 (Thumb mode) 


| | f. mut|| PROC 
PUSH 


{r4,lr} 
BL _ aeabi_lmul 
POP {r4,pc} 
ENDP 
|| f. div|| PROC 
PU {r4,lr} 
BL . aeabi uldivmod 
POP {r4,pc} 
ENDP 
| |f_rem|| PROC 
PU {r4,lr} 
BL . aeabi uldivmod 
MOVS r0,r2 
MOVS r1,r3 
POP {r4,pc} 


Keil for ARM mode, on the other hand, is able to produce 64-bit multiplication code: 


Listing 1.383: Optimizing Keil 6/2013 (ARM mode) 


| |f_ mul|| PROC 
PUSH {r4, lr} 
UMULL r12,r4,r0,r2 
MLA rl,r2,rl,r4 
MLA rl,r0,r3,r1 
MOV r0,r12 
POP {r4,pc} 
ENDP 
|| f, div|| PROC 
PUSH {r4, lr} 
BL . aeabi uldivmod 
POP {r4,pc} 
ENDP 
|| f. rem|| PROC 
PUSH {r4, lr} 
BL . aeabi uldivmod 
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MOV r0,r2 
MOV r1,r3 
POP {r4,pc} 
ENDP 


MIPS 


Optimizing GCC for MIPS can generate 64-bit multiplication code, but has to call a 


library routine for 64-bit division: 


Listing 1.384: Optimizing GCC 4.4.5 (IDA) 


f mul: 
mult $a2, fal 
mf lo $v0 
or gat, $zero ; NOP 
or gat, $zero ; NOP 
mult $a0, $a3 
mflo $a0 
addu $v0O, $a0 
or $at, $zero ; NOP 
multu $a3, $al 
mfhi $a2 
mflo $v1 
jr $ra 
addu $v0, $a2 
f div: 
var_10 = -0x10 
var 4 = -4 
lui $gp, ( gnu local gp >> 16) 
addiu  $sp, -0x20 
la $gp, (gnu local gp € OxFFFF) 
SW $ra, 0x20+var_4($sp) 
SW $gp, 0x20«var 10($sp) 
lw $t9, ( udivdi3 € OxFFFF)($9p) 
or $at, $zero 
jalr $t9 
or $at, $zero 
lw $ra, Ox20+var_4($sp) 
or $at, $zero 
jr $ra 
addiu  $sp, 0x20 
f rem: 
var 10 - -0x10 
var 4 = -4 
lui $gp, ( gnu local gp >> 16) 


addiu $sp, -0x20 
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la $gp, (gnu local gp € OxFFFF) 
SW $ra, 0x20+var_4($sp) 

SW $gp, 0x20«var 10($sp) 

lw $t9, ( umoddi3 € OxFFFF)($9p) 
or $at, $zero 

jalr $t9 

or gat, $zero 

lw $ra, Ox20+var_4($sp) 

or gat, $zero 

jr $ra 


addiu $sp, 0x20 


There are a lot of NOPs, probably delay slots filled after the multiplication instruction 
(it’s slower than other instructions, after all). 


1.34.4 Shifting right 


#include «stdint.h» 


uint64 t f (uint64 t a) 


{ 

return a>>7; 
}; 
x86 

Listing 1.385: Optimizing MSVC 2012 /Ob1 

a$= 8 ; size = 8 
f PROC 

mov eax, DWORD PTR a$[esp-4] 

mov edx, DWORD PTR a$[esp] 

shrd eax, edx, 7 

shr edx, 7 

ret 0 
f ENDP 

Listing 1.386: Optimizing GCC 4.8.1 -fno-inline 

f: 

mov edx, DWORD PTR [esp+8] 

mov eax, DWORD PTR [esp+4] 

shrd eax, edx, 7 

shr edx, 7 

ret 


Shifting also occurs in two passes: first the lower part is shifted, then the higher part. 
But the lower part is shifted with the help of the SHRD instruction, it shifts the value of 
EAX by 7 bits, but pulls new bits from EDX, i.e., from the higher part. In other words, 
64-bit value from EDX: EAX register's pair, as a whole, is shifted by 7 bits and lowest 
32 bits of result are placed into EAX. The higher part is shifted using the much more 
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popular SHR instruction: indeed, the freed bits in the higher part must be filled with 
zeros. 


ARM 


ARM doesn't have such instruction as SHRD in x86, so the Keil compiler ought to do 
this using simple shifts and OR operations: 


Listing 1.387: Optimizing Keil 6/2013 (ARM mode) 


|| f] |] PROC 

LSR r0,r0,#7 

ORR r0,r0,r1,LSL #25 

LSR r1,r1,#7 

BX lr 

ENDP 

Listing 1.388: Optimizing Keil 6/2013 (Thumb mode) 

|| f] |] PROC 

LSLS r2,r1,#25 

LSRS r0,r0,#7 

ORRS r0,r0,r2 

LSRS r1,r1,#7 

BX lr 

ENDP 
MIPS 


GCC for MIPS follows the same algorithm as Keil does for Thumb mode: 


Listing 1.389: Optimizing GCC 4.4.5 (IDA) 


f: 
sll $v0, $a0, 25 
srl $v1, $al, 7 
or $vl, $v0, $v1 
jr $ra 
srl $v0, $a0, 7 


1.34.5 Converting 32-bit value into 64-bit one 


#include «stdint.h» 


int64 t f (int32 t a) 
1 


ti 


return a; 
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x86 
Listing 1.390: Optimizing MSVC 2012 

_a$ = 8 
_f PROC 

mov eax, DWORD PTR a$[esp-4] 

cdq 

ret 0 
f ENDP 


Here we also run into necessity to extend a 32-bit signed value into a 64-bit signed 
one. Unsigned values are converted straightforwardly: all bits in the higher part 
must be set to 0. But this is not appropriate for signed data types: the sign has to 
be copied into the higher part of the resulting number. 


The CDQ instruction does that here, it takes its input value in EAX, extends it to 64-bit 
and leaves it in the EDX:EAX register pair. In other words, CDQ gets the number sign 
from EAX (by getting the most significant bit in EAX), and depending of it, sets all 32 
bits in EDX to O or 1. Its operation is somewhat similar to the MOVSX instruction. 


ARM 
Listing 1.391: Optimizing Keil 6/2013 (ARM mode) 
|||] PROC 
ASR r1,r0,#31 
BX lr 
ENDP 


Keil for ARM is different: it just arithmetically shifts right the input value by 31 bits. 
As we know, the sign bit is MSB, and the arithmetical shift copies the sign bit into 
the "emerged" bits. So after “ASR r1,r0,#31”, R1 containing OxFFFFFFFF if the input 
value has been negative and 0 otherwise. R1 contains the high part of the resulting 
64-bit value. In other words, this code just copies the MSB (sign bit) from the input 
value in RO to all bits of the high 32-bit part of the resulting 64-bit value. 


MIPS 
GCC for MIPS does the same as Keil did for ARM mode: 
Listing 1.392: Optimizing GCC 4.4.5 (IDA) 


f: 
sra $v0, $a0, 31 
jr $ra 
move $v1, $a0 
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1.35 LARGE INTEGER structure case 


Imagine this: late 1980s, you're Microsoft, and you're developing a new serious OS 
(Windows NT), that will compete with Unices. Target platforms has both 32-bit and 
64-bit CPUs. And you need a 64-bit integer datatype for all sort of purposes, starting 
at FILETIME?6 structure. 


The problem: not all target C/C++ compilers support 64-bit integer yet (this is late 
1980s). Surely, this will be changed in (near) future, but not now. What would you 
do? 


While reading this, try to stop (and/or close this book) and think, how can you solve 
this problem. 


166https://docs.microsoft.com/en-us/windows/desktop/api/minwinbase/ 
ns-minwinbase- filetime 
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This is what Microsoft did, something like this": 


union ULARGE INTEGER 
{ 


struct backward compatibility 


DWORD LowPart; 
DWORD HighPart; 


ur 

#ifdef NEW FANCY COMPILER SUPPORTING 64 BIT 
ULONGLONG QuadPart; 

Hendif 

u 


This is a chunk of 8 bytes, which can be accessed via 64-bit integer QuadPart (if 
compiled using newer compiler), or using two 32-bit integers (if compiled using old 
one). 


QuadPart field is just absent here when compiled using old compiler. 


Order is crucial: first field (LowPart) maps to lower 4 bytes of 64-bit value, second 
field (HighPart) maps to higher 4 bytes. 


Microsoft also added utility functions for all the arithmetical operation, in a same 
manner as | already described: 1.34 on page 497. 


And this is from the leaked Windows 2000 source code base: 


Listing 1.393: i386 arch 


++ 
; LARGE INTEGER 

; RtlLargeIntegerAdd ( 

; IN LARGE INTEGER Addend1, 


; IN LARGE INTEGER Addend2 
FER 


; Routine Description: 


; This function adds a signed large integer to a signed large integer and 
; returns the signed large integer result. 


; Arguments: 


; (TOS+4) = Addendl - first addend value 
; (TOS+12) = Addend2 - second addend value 


; Return Value: 


; The large integer result is stored in (edx:eax) 


167Not a copypasted source code, | wrote this 
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cPublicProc RtlLargeIntegerAdd ,4 
cPublicFpo 4,0 


mov eax, [esp]+4 ; (eax)=add1. low 
add eax, [esp]+12 ; (eax)=sum. Low 
mov edx, [esp]+8 ; (edx)=add1.hi 
adc edx, [esp]+16 ; (edx)ssum.hi 
StdRET _RtlLargeIntegerAdd 


StdENDP RtlLargeIntegerAdd 


Listing 1.394: MIPS arch 


LEAF ENTRY (RtlLargeIntegerAdd) 


lw t0,4 * 4(sp) // get low part of addend2 value 
lw t1,4 * 5(sp) // get high part of addend2 value 
addu t0,t0,a2 // add low parts of large integer 
addu t1,t1,a3 // add high parts of large integer 
situ t2,t0,a2 // generate carry from low part 
addu t1,t1,t2 // add carry to high part 

sw t0,0(a0) // store low part of result 

sw t1,4(a0) // store high part of result 

move v0,a0 // set function return register 

j ra // return 


.end RtlLargeIntegerAdd 


Now two 64-bit architectures: 


Listing 1.395: Itanium arch 


LEAF ENTRY (RtlLargeIntegerAdd) 

add vO = a0, al // add both quadword 7 
y arguments 

LEAF RETURN 


LEAF EXIT(RtlLargeIntegerAdd) 


Listing 1.396: DEC Alpha arch 


LEAF ENTRY (RtlLargeIntegerAdd) 


addq a0, al, vO // add both quadword arguments 
ret zero, (ra) // return 


.end RtlLargeIntegerAdd 


No need using 32-bit instructions on Itanium and DEC Alpha—64-bit ones are here 
already. 


And this is what we can find in Windows Research Kernel: 
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DECLSPEC DEPRECATED DDK // Use native  int64 math 
_ inline 
LARGE INTEGER 
NTAPI 
RtlLargeIntegerAdd ( 
LARGE INTEGER Addendl, 
LARGE INTEGER Addend2 
) 


1 
LARGE INTEGER Sum; 
Sum.QuadPart = Addend1.QuadPart + Addend2.QuadPart; 
return Sum; 

} 


All these functions can be dropped (in future), but now they just operate on Quad- 
Part field. If this piece of code is to be compiled using a modern 32-bit compiler 
(that supports 64-bit integer), it will generate two 32-bit additions under the hood. 
From this moment, LowPart/HighPart fields can be dropped from the LARGE_INTEGER 
union/structure. 


Would you use such a technique today? Probably not, but if someone would need 
128-bit integer data type, you can implement it just like this. 


Also, needless to say, this works thanks to little-endian (2.2 on page 572) (all ar- 
chitectures Windows NT was developed for are little-endian). This trick wouldn't be 
possible on a big-endian architecture. 


1.36 SIMD 


SIMD is an acronym: Single Instruction, Multiple Data. 

As its name implies, it processes multiple data using only one instruction. 
Like the FPU, that CPU subsystem looks like a separate processor inside x86. 
SIMD began as MMX in x86. 8 new 64-bit registers appeared: MMO-MM7. 


Each MMX register can hold 2 32-bit values, 4 16-bit values or 8 bytes. For example, 
it is possible to add 8 8-bit values (bytes) simultaneously by adding two values in 
MMX registers. 


One simple example is a graphics editor that represents an image as a two dimen- 
sional array. When the user changes the brightness of the image, the editor must 
add or subtract a coefficient to/from each pixel value. For the sake of brevity if we 
say that the image is grayscale and each pixel is defined by one 8-bit byte, then it 
is possible to change the brightness of 8 pixels simultaneously. 


By the way, this is the reason why the saturation instructions are present in SIMD. 


When the user changes the brightness in the graphics editor, overflow and underflow 
are not desirable, so there are addition instructions in SIMD which are not adding 
anything if the maximum value is reached, etc. 
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When MMX appeared, these registers were actually located in the FPU's registers. It 
was possible to use either FPU or MMX at the same time. One might think that Intel 
saved on transistors, but in fact the reason of such symbiosis was simpler —older 
OSes that are not aware of the additional CPU registers would not save them at the 
context switch, but saving the FPU registers. Thus, MMX-enabled CPU + old OS + 
process utilizing MMX features will still work. 


SSE—is extension of the SIMD registers to 128 bits, now separate from the FPU. 
AVX—another extension, to 256 bits. 
Now about practical usage. 


Of course, this is memory copy routines (memcpy), memory comparing (memcmp) and 
SO On. 


One more example: the DES encryption algorithm takes a 64-bit block and a 56- 
bit key, encrypt the block and produces a 64-bit result. The DES algorithm may be 
considered as a very large electronic circuit, with wires and AND/OR/NOT gates. 


Bitslice DES!9? —is the idea of processing groups of blocks and keys simultaneously. 
Let's say, variable of type unsigned int on x86 can hold up to 32 bits, so it is possi- 
ble to store there intermediate results for 32 block-key pairs simultaneously, using 
64456 variables of type unsigned int. 


There is an utility to brute-force Oracle RDBMS passwords/hashes (ones based on 
DES), using slightly modified bitslice DES algorithm for SSE2 and AVX—now it is 
possible to encrypt 128 or 256 block-keys pairs simultaneously. 


http://conus.info/utils/ops SIMD/ 


1.36.1 Vectorization 


Vectorization*?? is when, for example, you have a loop taking couple of arrays for 
input and producing one array. The loop body takes values from the input arrays, 
does something and puts the result into the output array. Vectorization is to process 
several elements simultaneously. 


Vectorization is not very fresh technology: the author of this textbook saw it at least 
on the Cray Y-MP supercomputer line from 1988 when he played with its “lite” version 
Cray Y-MP EL 17°, 


For example: 


for (1 = 0; i < 1024; i++) 


Cli] = Afi] *Blil; 


This fragment of code takes elements from A and B, multiplies them and saves the 
result into C. 


1685ttp://www.darkside.com.au/bitslice/ 
16% wikipedia: vectorization 
170Remotely. It is installed in the museum of supercomputers: http://www. cray-cyber.org 
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If each array element we have is 32-bit int, then it is possible to load 4 elements from 
A into a 128-bit XMM-register, from B to another XMM-registers, and by executing 
PMULLD (Multiply Packed Signed Dword Integers and Store Low Result) and PMULHW 
(Multiply Packed Signed Integers and Store High Result), it is possible to get 4 64-bit 
products at once. 


Thus, loop body execution count is 1024/4 instead of 1024, that is 4 times less and, 
of course, faster. 
Addition example 


Some compilers can do vectorization automatically in simple cases, e.g., Intel C-- 17, 


Here is tiny function: 


int f (int sz, int *arl, int *ar2, int *ar3) 


1 
for (int i20; i<sz; i++) 
ar3[i]J=arl[i]+ar2[i]; 
return 0; 
i 
Intel C++ 


Let's compile it with Intel C++ 11.1.051 win32: 
icl intel.cpp /QaxSSE2 /Faintel.asm /0x 
We got (in IDA): 


; int cdecl f(int, int *, int *, int *) 
public ?f@@YAHHPAHO0@Z 
? f@@YAHHPAHOO@Z proc near 


var 10 = dword ptr -10h 
SZ - dword ptr 4 
arl = dword ptr 8 
ar2 = dword ptr  OCh 
ar3 = dword ptr 10h 
push edi 
push esi 
push ebx 
push esi 
mov edx, [esp*10h«sz] 
test edx, edx 
jte loc 15B 
mov eax, [esp+10h+ar3] 
cmp edx, 6 
jte loc 143 


171More about Intel C++ automatic vectorization: Excerpt: Effective Automatic Vectorization 
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cmp 
jbe 
mov 
sub 
lea 


loc 36: ; CODE 


loc 55: ; CODE 


loc 67: ; CODE 


loc 7F: ; CODE 


loc 9A: ; CODE 


eax, [esp+10h+ar2] 
short loc 36 

esi, [esp+10h+ar2] 
esi, eax 

ecx, ds:0[edx*4] 
esi 

ecx, esi 

short loc 55 


XREF: f(int,int *,int *,int *)+21 
eax, [esp+10h+ar2] 

loc 143 

esi, [esp+10h+ar2] 

esi, eax 

ecx, ds:0[edx*4] 

esi, ecx 

loc 143 


XREF: f(int,int *,int *,int *)+34 
eax, [esp*10h«ar1] 

short loc 67 

esi, [esp*10h«ar1] 

esi, eax 

esi 

ecx, esi 

short loc 7F 


XREF: f(int,int *,int *,int *)+59 
eax, [esp*10h«ar1] 


loc 143 

esi, [esp+10h+ar1] 

esi, eax 

esi, ecx 

loc 143 

XREF: f(int,int *,int *,int *)+65 
edi, eax ; edi = ar3 

edi, OFh ; is ar3 16-byte aligned? 
short loc 9A ; yes 

edi, 3 

loc 162 

edi 

edi, 10h 

edi, 2 


XREF: f(int,int *,int *,int *)+84 
ecx, [edi+4] 


edx, ecx 
loc 162 
ecx, edx 
ecx, edi 
ecx, 3 
ecx 
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loc C1: ; 


loc D6: ; 


loc ED: ; 
mov 
mov 


ecx, edx 

t edi, edi 
short loc D6 
ebx, [esp+10h+ar2] 
[esp+10h+var_10], ecx 
ecx, [esp*10h«ar1] 
esi, esi 


CODE XREF: f(int,int *,int *,int *)+CD 
edx, [ecx+esi*4] 
edx, [ebx+esi*4] 
[eax+esi*4], edx 
esi 
esi, edi 
short loc C1 
ecx, [esp+10h+var_ 10] 
edx, [esp*10h«sz] 


CODE XREF: f(int,int *,int *,int *)+B2 

esi, [esp+10h+ar2] 

esi, [esi+edi*4] ; is ar2+i*4 16-byte aligned? 
t esi, OFh 

short loc 109 ; yes! 

ebx, [esp*10h«ar1] 

esi, [esp+10h+ar2] 


CODE XREF: f(int,int *,int *,int *)+105 
dqu xmml, xmmword ptr [ebx+edi*4] ; arl+i*4 
dqu xmm0, xmmword ptr [esi+edi*4] ; ar2+i*4 is not 16-byte 


aligned, so load it to XMMO 


pad 


loc 109: ; 
mov 
mov 


loc 111: ; 


loc 127: ; 


dd xmml, xmm0 

dqa xmmword ptr [eax+edi*4], xmml ; ar3+i*4 
edi, 4 
edi, ecx 


short loc ED 
short loc 127 


CODE XREF: f(int,int *,int *,int *)+E3 
ebx, [esp*10h«ar1] 
esi, [esp+10h+ar2] 


CODE XREF: f(int,int *,int *,int *)+125 
dqu xmm0, xmmword ptr [ebx+edi*4] 


dd xmm0, xmmword ptr [esi+edi*4] 
dqa xmmword ptr [eax+edi*4], xmm0 
edi, 4 
edi, ecx 


short loc 111 


CODE XREF: f(int,int *,int *,int *)+107 
f(int,int *,int *,int *)+164 

ecx, edx 

short loc 15B 

esi, [esp*10h«ar1] 
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mov edi, [esp+10h+ar2] 


loc 133: ; CODE XREF: f(int,int *,int *,int *)+13F 


mov ebx, [esitecx*4] 
add ebx, [edi+ecx*4] 
mov [eax+ecx*4], ebx 
inc ecx 

cmp ecx, edx 

jb short loc 133 
jmp short loc 15B 


loc 143: ; CODE XREF: f(int,int *,int *,int *)+17 
; f(int,int *,int *,int *)+3A ... 


mov esi, [esp*10h«ar1] 
mov edi, [esp+10h+ar2] 
xor ecx, ecx 


loc 14D: ; CODE XREF: f(int,int *,int *,int *)+159 


mov ebx, [esitecx*4] 
add ebx, [edi+ecx*4] 
mov [eax+ecx*4], ebx 
inc ecx 

cmp ecx, edx 

jb short loc 14D 


loc 15B: ; CODE XREF: f(int,int *,int *,int *)+A 
; f(int,int *,int *,int *)+129 ... 


xor eax, eax 
pop ecx 

pop ebx 

pop esi 

pop edi 

retn 


loc 162: ; CODE XREF: f(int,int *,int *,int *)+8C 
; f(int,int *,int *,int *)+9F 
xor ecx, ecx 
jmp short loc 127 
?F@@YAHHPAHOO@Z endp 


The SSE2-related instructions are: 


* MOVDQU (Move Unaligned Double Quadword)—just loads 16 bytes from memory 
into a XMM-register. 


PADDD (Add Packed Integers)—adds 4 pairs of 32-bit numbers and leaves the 
result in the first operand. By the way, no exception is raised in case of overflow 
and no flags are to be set, just the low 32 bits of the result are to be stored. If 
one of PADDD's operands is the address of a value in memory, then the address 
must be aligned on a 16-byte boundary. If it is not aligned, an exception will be 
triggered. 


* MOVDQA (Move Aligned Double Quadword) is the same as MOVDQU, but requires 
the address of the value in memory to be aligned on a 16-bit boundary. If it 
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is not aligned, exception will be raised. MOVDQA works faster than MOVDQU, but 
requires aforesaid. 


So, these SSE2-instructions are to be executed only in case there are more than 4 
pairs to work on and the pointer ar3 is aligned on a 16-byte boundary. 


Also, if ar2 is aligned on a 16-byte boundary as well, this fragment of code is to be 
executed: 


movdqu xmm0, xmmword ptr [ebx+edi*4] ; arl+i*4 
paddd xmm0, xmmword ptr [esi+edi*4] ; ar2+i*4 
movdqa xmmword ptr [eax+edi*4], xmm0 ; ar3+i*4 


Otherwise, the value from ar2 is to be loaded into XMMO using MOVDQU, which does 
not require aligned pointer, but may work slower: 


movdqu xmml, xmmword ptr [ebx+edi*4] ; arl+i*4 
movdqu xmmO, xmmword ptr [esi+edi*4] ; ar2+i*4 is not 16-byte aligned, so 


load it to XMMO 
paddd xmml1, xmm0 


movdqa xmmword ptr [eax+edi*4], xmml ; ar3+i*4 


In all other cases, non-SSE2 code is to be executed. 
GCC 
GCC may also vectorize in simple cases?!"?, if the -03 option is used and SSE2 support 


is turned on: -msse2. 
What we get (GCC 4.4.1): 


; f(int, int *, int *, int *) 
public Z1fiPiS S. 
_Z1fiPiS S proc near 


var 18 - dword ptr -18h 
var 14 - dword ptr -14h 
var 10 - dword ptr -10h 
arg 0 = dword ptr 8 
arg 4 = dword ptr  OCh 
arg 8 = dword ptr 10h 
arg C - dword ptr 14h 
push ebp 
mov ebp, esp 
push edi 
push esi 
push ebx 
sub esp, OCh 
mov ecx, [ebp«arg 0] 
mov esi, [ebptarg 4] 


172More about GCC vectorization support: http://gcc.gnu.org/projects/tree-ssa/vectorization. 
html 
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mov 
mov 
tes 
jte 
cmp 
lea 
ja 


loc 80484C1: ; 
xor 
nop 
lea 


loc 80484C8: ; 


loc 80484D8: ; 
add 
xor 
pop 
pop 
pop 
pop 
ret 


ali 


loc 80484E8: ; 
tes 
jnz 
lea 
cmp 
jbe 


loc 80484F8: ; 
lea 
cmp 
ja 
cmp 
jbe 


loc 8048503: ; 
mov 
shr 
mov 
shl 


edi, [ebp«arg 8] 

ebx, [ebp«arg C] 
t ecx, ecx 

short loc 80484D8 

ecx, 6 

eax, [ebx+10h] 

short loc 80484E8 


CODE XREF: f(int,int *,int *,int *)+4B 
f(int,int *,int *,int *)+61 ... 
eax, eax 


esi, [esi+0] 


CODE XREF: f(int,int *,int *,int *)+36 
edx, [edi+eax*4] 
edx, [esi+eax*4] 
[ebx+eax*4], edx 
eax, 1 
eax, ecx 
short loc 80484C8 


CODE XREF: f(int,int *,int *,int *)+17 
f(int,int *,int *,int *)+A5 

esp, OCh 

eax, eax 

ebx 

esi 

edi 

ebp 
n 


gn 8 


CODE XREF: f(int,int *,int *,int *)+1F 
t bl, OFh 

short loc 80484C1 

edx, [esi+10h] 

ebx, edx 

loc 8048578 


CODE XREF: f(int,int *,int *,int *)+E0 


edx, [edi+10h] 
ebx, edx 
short loc 8048503 
edi, eax 
short loc 80484C1 
CODE XREF: f(int,int *,int *,int *)+5D 
eax, ecx 
eax, 2 
[ebp+var_14], eax 
eax, 2 
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loc 8048520: 


loc 8048547: 


loc 8048558: 


loc 8048578: 


_Z1fiPiS S- 


test 
mov 
jz 
mov 
mov 
xor 
xor 
nop 


eax, eax 
[ebp-var 10], eax 
short loc 8048547 
[ebp-var 18], ecx 
ecx, [ebp-var 14] 
eax, eax 

edx, edx 


; CODE XREF: f(int,int *,int *,int *)+9B 


movdqu 
movdqu 
add 


xmm1, xmmword ptr [edi+eax] 
xmm0, xmmword ptr [esi+eax] 
edx, 1 

xmmO, xmml 

xmmword ptr [ebx+eax], xmm0 
eax, 10h 

edx, ecx 

short loc 8048520 

ecx, [ebp+var_18] 

eax, [ebp+var_10] 

ecx, eax 

short loc 80484D8 


; CODE XREF: f(int,int *,int *,int *)+73 


lea 
add 
add 
add 
lea 


edx, ds:O[eax*4] 
esi, edx 

edi, edx 

ebx, edx 

esi, [esi+0] 


; CODE XREF: f(int,int *,int *,int *)+CC 


mov 
add 
add 
add 
add 
mov 
add 
cmp 
jg 
add 
xor 
pop 
pop 
pop 
pop 
retn 


edx, [edi] 
eax, 1 
edi, 4 
edx, [esi] 
esi, 4 
[ebx], edx 
ebx, 4 
ecx, eax 
short loc 8048558 
esp, OCh 
eax, eax 
ebx 

esi 

edi 

ebp 


; CODE XREF: f(int,int *,int *,int *)+52 


cmp 
jnb 
jmp 
endp 


eax, esi 
loc 80484C1 
loc 80484F8 
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Almost the same, however, not as meticulously as Intel C++. 


Memory copy example 


Let's revisit the simple memcpy() example (1.22.2 on page 246): 


#include <stdio.h> 


void my_memcpy (unsigned char* dst, unsigned char* src, size t cnt) 
{ 
size t i; 
for (i=0; i<cnt; i++) 
dst[il=src[i]; 
}; 


And that's what optimizations GCC 4.9.1 did: 
Listing 1.397: Optimizing GCC 4.9.1 x64 


my memcpy: 
; RDI = destination address 


; RSI = source address 
; RDX = size of block 
test rdx, rdx 
je .L41 
lea rax, [rdi+16] 
cmp rsi, rax 
lea rax, [rsi+16] 
setae cl 
cmp rdi, rax 
setae al 
or cl, al 
je .L13 
cmp rdx, 22 
jbe .L13 
mov rcx, rsi 
push rbp 
push rbx 
neg rcx 
and ecx, 15 
cmp rcx, rdx 
cmova rcx, rdx 
xor eax, eax 
test rcx, rcx 
je .L4 
movzx eax, BYTE PTR [rsi] 
cmp rcx, 1 
mov BYTE PTR [rdi], al 
je .L15 
movzx eax, BYTE PTR [rsi+1] 
cmp rcx, 2 
mov BYTE PTR [rdi+1], al 
je .L16 


movzx eax, BYTE PTR [rsi+2] 
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cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
je 
movzx 
cmp 
mov 
jne 
movzx 
mov 
mov 

.L4: 
mov 
lea 


rcx, 
BYTE 
.L17 
eax, 
rcx, 
BYTE 
.L18 
eax, 
rcx, 
BYTE 
.L19 
eax, 
rcx, 
BYTE 
.L20 
eax, 
rcx, 
BYTE 
.L21 
eax, 
rcx, 
BYTE 
.L22 
eax, 
rcx, 
BYTE 
.L23 
eax, 
rcx, 
BYTE 
.L24 
eax, 
rcx, 
BYTE 
.L25 
eax, 
rcx, 
BYTE 
.L26 
eax, 
rcx, 
BYTE 
.L27 
eax, 
rcx, 
BYTE 
.L28 
eax, 
BYTE 
eax, 


r10, 
r9, 


3 
PTR [rdi+2], al 


BYTE PTR [rsi+3] 
4 
PTR [rdi+3], al 


BYTE PTR [rsi+4] 
5 
PTR [rdi+4], al 


BYTE PTR [rsi+5] 
6 
PTR [rdi+5], al 


BYTE PTR [rsi+6] 
7 
PTR [rdi+6], al 


BYTE PTR [rsi+7] 
8 
PTR [rdi+7], al 


BYTE PTR [rsi+8] 
9 
PTR [rdi+8], al 


BYTE PTR [rsi+9] 
10 
PTR [rdi+9], al 


BYTE PTR [rsi+10] 
11 
PTR [rdi+10], al 


BYTE PTR [rsi+11] 
12 
PTR [rdi+11], al 


BYTE PTR [rsi+12] 
13 
PTR [rdi+12], al 


BYTE PTR [rsi+13] 
15 
PTR [rdi+13], al 


BYTE PTR [rsi+14] 
PTR [rdi+14], al 
15 


rdx 


[rdx-1] 
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sub 
lea 
sub 
shr 
add 
mov 
sal 
cmp 
jbe 
lea 
xor 
add 
xor 
L7: 
movdqa 
add 
movups 
add 


.L6: 


r10, rcx 

r8, [r10-16] 
r9, rcx 

r8, 4 

r8, 1 

rll, r8 

rll, 4 

r9, 14 

.L6 

rbp, [rsitrcx] 
r9d, r9d 
rcx, rdi 
ebx, ebx 


xmm0, XMMWORD PTR [rbp+0+r9] 
rbx, 1 

XMMWORD PTR [rcx+r9], xmmO 
r9, 16 

rbx, r8 

.L7 

rax, r11 

r10, r11 

.L1 


ecx, BYTE PTR [rsi+rax] 
BYTE PTR [rdi+rax], cl 
rcx, [rax+1] 

rdx, rcx 

.L1 

ecx, BYTE PTR [rsi+l+rax] 
BYTE PTR [rdi+l+rax], cl 
rcx, [rax+2] 

rdx, rcx 

.L1 

ecx, BYTE PTR [rsi+2+rax] 
BYTE PTR [rdi+2+rax], cl 
rcx, [rax+3] 

rdx, rcx 

.L1 

ecx, BYTE PTR [rsi+3+rax] 
BYTE PTR [rdi+3+rax], cl 
rcx, [rax+4] 

rdx, rcx 

.L1 

ecx, BYTE PTR [rsi+4+rax] 
BYTE PTR [rdi+4+rax], cl 
rcx, [rax+5] 

rdx, rcx 

.L1 

ecx, BYTE PTR [rsi+5+rax] 
BYTE PTR [rdi+5+rax], cl 
rcx, [rax+6] 

rdx, rcx 
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jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
lea 
cmp 
jbe 
movzx 
mov 
.L1: 
pop 
pop 
.L41: 
rep ret 
.L13: 
xor 
.L3: 
movzx 
mov 


.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

ecx, 
BYTE 
rcx, 
rdx, 
.L1 

edx, 
BYTE 


rbx 
rbp 


eax, 


ecx, 
BYTE 


BYTE PTR [rsi+6+rax] 
PTR [rdi+6+rax], cl 
[rax+7] 

rcx 


BYTE PTR [rsi+7+rax] 
PTR [rdi+7+rax], cl 
[rax+8] 

rcx 


BYTE PTR [rsi+8+rax] 
PTR [rdi+8+rax], cl 
[rax+9] 

rcx 


BYTE PTR [rsi+9+rax] 
PTR [rdi+9+rax], cl 
[rax+10] 

rcx 


BYTE PTR [rsi+10+rax] 
PTR [rdi+10+rax], cl 
[rax+11] 

rcx 


BYTE PTR [rsi+11+rax] 
PTR [rditll+rax], cl 
[rax+12] 

rcx 


BYTE PTR [rsi+12+rax] 
PTR [rdi+12+rax], cl 
[rax+13] 

rcx 


BYTE PTR [rsi+13+rax] 
PTR [rdi+13+rax], cl 
[rax+14] 

rcx 


BYTE PTR [rsi+14+rax] 
PTR [rdi+14+rax], dl 


eax 


BYTE PTR [rsi+rax] 
PTR [rdi+rax], cl 
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.L28: 


.L15: 


.L16: 


.L17: 


.L18: 


.L19: 


.L20: 


.L21: 


.L22: 


.L23: 


.L24: 


.L25: 


.L26: 


.L27: 


add 
cmp 
jne 
rep 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 
mov 
jmp 


ret 


rax, 
rax, 
.L3 


eax, 


.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


eax, 
.L4 


rdx 


14 


10 


11 


12 


13 
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1.36.2 SIMD strlen() implementation 


It has to be noted that the SIMD instructions can be inserted in C/C++ code via 
special macros!^?. For MSVC, some of them are located in the intrin.h file. 


It is possible to implement the strlen() function! "^ using SIMD instructions that 
works 2-2.5 times faster than the common implementation. This function loads 16 
characters into a XMM-register and check each against zero !”°. 


size t strlen sse2(const char *str) 
1 
register size t len = 0; 
const char *s=str; 
bool str is aligned=(((unsigned int)str)&OxFFFFFFF0) == (unsigned int)? 
S str; 


if (str is aligned--false) 
return strlen (str); 


. m128i xmm0 = mm setzero si128(); 
. m128i xmml; 
int mask = 0; 


for (;;) 

1 

mm load sil28(( m128i *)s); 

mm cmpeq epi8(xmml, xmm0); 

ask = mm movemask epi8(xmm1)) !- 0) 


xmm1 
xmm1 
if (( 
{ 


3 Wu I 


unsigned long pos; 
 BitScanForward(&pos, mask); 
len += (size t)pos; 


break; 


} 

S += sizeof( m128i); 

len += sizeof( m128i); 
s 


return len; 


Let's compile it in MSVC 2010 with /0x option: 


Listing 1.398: Optimizing MSVC 2010 
| pos$75552 = -4 ; size = 4 
_str$ = 8 ; size = 4 
?strlen_sse2@@YAIPBD@Z PROC ; strlen sse2 


push ebp 


173MSDN: MMX, SSE, and SSE2 Intrinsics 
14strlen() —standard C library function for calculating string length 
175The example is based on source code from: http://www.strchr.com/sse2 optimised strlen 
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mov ebp, esp 

and esp, -16 ; fffffffOH 

mov eax, DWORD PTR str$[ebp] 

sub esp, 12 ; 0000000cH 

push esi 

mov esi, eax 

and esi, -16 ; FfffffffOH 

xor edx, edx 

mov ecx, eax 

cmp esi, eax 

je SHORT $LN4Qstrlen sse 

lea edx, DWORD PTR [eax+1] 

npad 3 ; align next label 
$LL11Gstrlen sse: 

mov cl, BYTE PTR [eax] 

inc eax 

test cl, cl 

jne SHORT $LL11@strlen_sse 

sub eax, edx 

pop esi 

mov esp, ebp 

pop ebp 

ret 0 


$LNAGstrlen sse: 

movdqa xmm1, XMMWORD PTR [eax] 

pxor xmmO, xmm0 

pcmpeqb  xmml, xmm0 

pmovmskb eax, xmml 

test eax, eax 

jne SHORT $LN9@strlen_sse 
$LL3@strlen_sse: 

movdqa xmm1, XMMWORD PTR [ecx+16] 


add ecx, 16 ; 00000010H 
pcmpeqb  xmml, xmmO 
add edx, 16 ; 00000010H 
pmovmskb eax, xmml 
test eax, eax 
je SHORT $LL3@strlen_sse 
$LN9Gstrlen_sse: 
bsf eax, eax 
mov ecx, eax 
mov DWORD PTR _pos$75552[esp+16], eax 
lea eax, DWORD PTR [ecx+edx] 
pop esi 
mov esp, ebp 
pop ebp 
ret 0 
?strlen_sse2@@YAIPBD@Z ENDP ; strlen sse2 


How it works? First of all, we must understand goal of the function. It calculates 
C-string length, but we can use different terms: it’s task is searching for zero byte, 
and then calculating its position relatively to string start. 
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First, we check if the str pointer is aligned on a 16-byte boundary. If not, we call the 
generic strlen() implementation. 


Then, we load the next 16 bytes into the XMM1 register using MOVDQA. 


An observant reader might ask, why can't MOVDQU be used here since it can load data 
from the memory regardless pointer alignment? 


Yes, it might be done in this way: if the pointer is aligned, load data using MOVDQA, if 
not —use the slower MOVDQU. 


But here we are may hit another caveat: 


In the Windows NT line of OS (but not limited to it), memory is allocated by pages of 
4 KiB (4096 bytes). Each win32-process has 4 GiB available, but in fact, only some 
parts of the address space are connected to real physical memory. If the process 
is accessing an absent memory block, an exception is to be raised. That's how VM 
works?/°, 


So, a function loading 16 bytes at once may step over the border of an allocated 
memory block. Let's say that the OS has allocated 8192 (0x2000) bytes at address 
0x008c0000. Thus, the block is the bytes starting from address 0x008c0000 to 
0x008c1fff inclusive. 


After the block, that is, starting from address 0x008c2000 there is nothing at all, e.g. 
the OS not allocated any memory there. Any attempt to access memory starting 
from that address will raise an exception. 


And let’s consider the example in which the program is holding a string that contains 
5 characters almost at the end of a block, and that is not a crime. 


0x008c1ff8 | 'h' 
Ox008c1ff9 | 'e' 
"|? 
"|? 


0x008c1ffa 
0x008c1ffb 
Ox008clffc | 'o' 
0x008c1ffd | ^x00' 
0x008c1ffe | random noise 
0x008c1fff | random noise 


So, in normal conditions the program calls strlen(), passing ita pointerto the string 
'hello' placed in memory at address Ox008c1ff8. strlen() reads one byte at a 
time until OxOO08c1ffd, where there's a zero byte, and then it stops. 


Now if we implement our own strlen() reading 16 bytes at once, starting at any 
address, aligned or not, MOVDQU may attempt to load 16 bytes at once at address 
0x008c1ff8 up to 0x008c2008, and then an exception will be raised. That situation 
is to be avoided, of course. 


So then we'll work only with the addresses aligned on a 16 bytes boundary, which 
in combination with the knowledge that the OS' page size is usually aligned on a 
16-byte boundary gives us some warranty that our function will not read from unal- 
located memory. 


176wikipedia 
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Let's get back to our function. 


mm setzero sil128()—is a macro generating pxor xmm0, xmm0 —it just clears the 
XMMO register. 


mm load si128()—is a macro for MOVDQA, it just loads 16 bytes from the address 
into the XMM1 register. 


mm cmpeq epi8()—is a macro for PCMPEQB, an instruction that compares two XMM- 
registers bytewise. 


And if some byte is equals to the one in the other register, there will be Oxff at this 
point in the result or 0 if otherwise. 


For example: 


XMM1: 0x11223344556677880000000000000000 
XMMO: 0x11ab3444007877881111111111111111 


After the execution of pcmpeqb xmm1, xmm0, the XMM1 register contains: 
XMM1: Oxf fO000F fO000F f f f0000000000000000 


In our case, this instruction compares each 16-byte block with a block of 16 zero- 
bytes, which has been set in the XMMO register by pxor xmm0, xmm0. 


The next macro is mm movemask epi8() —that is the PMOVMSKB instruction. 
It is very useful with PCMPEQB. 
pmovmskb eax, xmml 


This instruction sets first EAX bit to 1 if the most significant bit of the first byte in 
XMM1 is 1. In other words, if the first byte of the XMM1 register is Oxff, then the first 
bit of EAX is to be 1, too. 


If the second byte in the XMM1 register is Oxff, then the second bit in EAX is to be set 
to 1. In other words, the instruction is answering the question "which bytes in XMM1 
has the most significant bit set, or greater than Ox7f", and returns 16 bits in the EAX 
register. The other bits in the EAX register are to be cleared. 


By the way, do not forget about this quirk of our algorithm. There might be 16 bytes 
in the input like: 


15 14 13 12 11 10 9 3 2 1 0 


'n e| 70] | 71] ojo garbage O garbage 


It is the 'hello' string, terminating zero, and some random noise in memory. 


If we load these 16 bytes into XMM1 and compare them with the zeroed XMMO, we are 
getting something like 177: 


XMM1: 0x0000ff00000000000000ff0000000000 
This means that the instruction found two zero bytes, and it is not surprising. 


PMOVMSKB in our case will set EAX to 
0b0010000000100000. 


177An order from MSB to LSB! 7? is used here. 
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Obviously, our function must take only the first zero bit and ignore the rest. 

The next instruction is BSF (Bit Scan Forward). 

This instruction finds the first bit set to 1 and stores its position into the first operand. 
EAX-0b0010000000100000 


After the execution of bsf eax, eax, EAX contains 5, meaning 1 has been found at 
the 5th bit position (starting from zero). 


MSVC has a macro for this instruction: BitScanForward. 


Now it is simple. If a zero byte has been found, its position is added to what we have 
already counted and now we have the return result. 


Almost all. 


By the way, itis also has to be noted that the MSVC compiler emitted two loop bodies 
side by side, for optimization. 


By the way, SSE 4.2 (that appeared in Intel Core i7) offers more instructions where 
these string manipulations might be even easier: http://www.strchr.com/strcmp 
and strlen using sse 4.2 


1.37 64 bits 
1.37.1 x86-64 


It is a 64-bit extension to the x86 architecture. 
From the reverse engineer's perspective, the most important changes are: 


* Almost all registers (except FPU and SIMD) were extended to 64 bits and got a 
R- prefix. 8 additional registers were added. Now GPR's are: RAX, RBX, RCX, RDX, 
RBP, RSP, RSI, RDI, R8, R9, R10, R11, R12, R13, R14, R15. 


It is still possible to access the older register parts as usual. For example, it is 
possible to access the lower 32-bit part of the RAX register using EAX: 


Byte number: 
7th | oth | 5th | 4th | 3rd | 2nd | 1st | Oth 
RAX*64 


EAX 


AX 
AH | AL 


The new R8-R15 registers also have their lower parts: R8D-R15D (lower 32-bit 
parts), R8W-R15W (lower 16-bit parts), R8L-R15L (lower 8-bit parts). 
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Byte number: 
7th | oth | 5th | 4th | 3rd | 2nd | 1st | Oth 
R8 


R8D 


R8W 
R8L 


The number of SIMD registers was doubled from 8 to 16: XMMO-XMM15. 


In Win64, the function calling convention is slightly different, somewhat resem- 
bling fastcall (6.1.3 on page 934). The first 4 arguments are stored in the RCX, 
RDX, R8, R9 registers, the rest —in the stack. The caller function must also al- 
locate 32 bytes so the callee may save there 4 first arguments and use these 
registers for its own needs. Short functions may use arguments just from reg- 
isters, but larger ones may save their values on the stack. 


System V AMD64 ABI (Linux, *BSD, Mac OS X)[Michael Matz, Jan Hubicka, An- 
dreas Jaeger, Mark Mitchell, System V Application Binary Interface. AMD64 Ar- 
chitecture Processor Supplement, (2013)] !"?also somewhat resembles fastcall, 
it uses 6 registers RDI, RSI, RDX, RCX, R8, R9 for the first 6 arguments. All the 
rest are passed via the stack. 


See also the section on calling conventions (6.1 on page 932). 
* The C/C++ int type is still 32-bit for compatibility. 
* All pointers are 64-bit now. 


Since now the number of registers is doubled, the compilers have more space for 
maneuvering called register allocation. For us this implies that the emitted code 
containing less number of local variables. 


For example, the function that calculates the first S-box of the DES encryption algo- 
rithm processes 32/64/128/256 values at once (depending on DES type type (uint32, 
uint64, SSE2 or AVX)) using the bitslice DES method (read more about this technique 
here (1.36 on page 514)): 


Generated S-box files. 


* 
* 

* This software may be modified, redistributed, and used for any purpose, 
* so long as its origin is acknowledged. 
" 
* 


Produced by Matthew Kwan - March 1998 


#ifdef WIN64 

#define DES type unsigned  int64 
#else 

#define DES type unsigned int 
#endif 


17Also available as  https://software.intel.com/sites/default/files/article/402129/ 
mpx- linux64-abi.pdf 
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void 
sl ( 
DES type al, 
DES type a2, 
DES type a3, 
DES type a4, 
DES type a5, 
DES type a6, 
DES type *outl, 
DES type *out2, 
DES type *out3, 
DES type *out4 
) A 
DES type X1, x2, x3, x4, x5, x6, x7, x8; 
DES type x9, x10, x11, x12, x13, x14, x15, 
DES type x17, x18, x19, x20, x21, x22, x23, 
DES type x25, x26, x27, x28, x29, x30, x31, 
DES type x33, x34, x35, x36, x37, x38, x39, 
DES type X41, x42, x43, x44, x45, x46, x47, 
DES type x49, x50, x51, x52, x53, x54, x55, 
xl = a3 & -a5; 
x2 = x1 ^ a4; 
x3 = a3 & ~a4; 
x4 = x3 | a5; 
x5 = a6 & x4; 
x6 = x2 ^ x5; 
x7 = a4 & ~a5; 
x8 = a3 ^ a4; 
x9 = a6 & -x8; 
x102x7^ x9; 
x11 = a2 | x10; 
x12 = x6 ^ x11; 
x13 = a5 ^ x5; 
x14 = x13 & x8; 
X15 = a5 & -a4; 
x16 = x3 ^ x14; 
x17 = a6 | x16; 
x18 = x15 ^ x17; 
x19 = a2 | x18; 
x20 = x14 ^ x19; 
x21 = al & x20; 
x22 = x12 ^ 21; 
*out2 ^= x22; 
x23 = x1]| x5; 
x24 = x23 ^ x8; 
x25 = x18 & ~x2; 
x26 = a2 & -x25; 
x27 = x24 ^ x26; 
x28 = x6 | x7; 
x29 = x28 ^ x25; 
x30 2 x9 ^ x24; 
x31 = x18 & ~x30; 


x16; 
x24; 
x32; 
x40; 
x48; 
x56; 
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x32 = a2 & x31; 
x33 = x29 ^ x32; 
x34 = al & x33; 
x35 = x27 ^ x34; 
*out4 ^= x35; 

x36 = a3 & x28; 
x37 = x18 & ~x36; 
x38 = a2 | x3; 
x39 = x37 ^ x38; 
x40 = a3 | x31; 
X41 = x24 & ~x37; 
x42 = x41 | x3; 
x43 = x42 & ~a2; 
x44 = x40 ^ x43; 
x45 = al & -x44; 
x46 = x39 ^ -x45; 
*outl ^= x46; 

x47 = x33 & -x9; 
x48 = x47 ^ x39; 
x49 = x4 ^ x36; 
x50 = x49 & -x5; 
x51 = x42 | x18; 
x52 = x51 ^ a5; 
x53 = a2 & ~x52; 
x54 = x50 ^ x53; 
x55 = al | x54; 
x56 = x48 ^ ~x55; 
*out3 ^= x56; 


There are a lot of local variables. Of course, not all those going into the local stack. 
Let's compile it with MSVC 2008 with /0x option: 


Listing 1.399: Optimizing MSVC 2008 


PUBLIC _sl 
; Function compile flags: /Ogtpy 
_ TEXT SEGMENT 


_x6$ = -20 ; size = 4 
_x3$ = -16 ; Size=4 
_x1$ = -12 ; size = 4 
_x8$ = -8 ; size = 4 
_x4$ = -4 ; size = 4 
_al$ = 8 ; size = 4 
_a2$ = 12 ; size = 4 
_a3$ = 16 ; size = 4 
_x33$ = 20 ; size = 4 
_x7$ = 20 ; size = 4 
_a4$ = 20 ; size = 4 
_a5$ = 24 ; size = 4 
tv326 = 28 ; size = 4 
_x36$ = 28 ; size = 4 
_x28$ = 28 ; size = 4 
 a6$ = 28 ; size = 4 
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_out1$ = 32 
_x24$ = 36 
_out2$ = 36 
_out3$ = 40 
_out4$ = 
_sl PROC 
sub 
mov 
push 
mov 
push 
push 
mov 
push 
mov 
not 
mov 
and 
mov 
not 
and 
mov 
and 
and 
mov 
xor 
mov 
or 
mov 
and 
mov 
mov 
xor 
mov 
mov 
xor 
mov 
xor 
mov 
and 
mov 
mov 
xor 
or 
not 
and 
xor 
mov 
or 
mov 
mov 
xor 
and 


BAHASA 


esp, 20 

edx, DWORD PTR _a5$[esp+16] 
ebx 

ebx, DWORD PTR _a4$[esp+20] 
ebp 

esi 

esi, DWORD PTR _a3$[esp+28] 
edi 


edi, ebx 
edi 
ebp, edi 


edi, DWORD PTR _a5$[esp+32] 
ecx, edx 


ecx 
ebp, esi 
eax, ecx 
eax, esi 
ecx, ebx 


DWORD PTR _x1$[esp+36], eax 
eax, ebx 
esi, ebp 
esi, edx 
DWORD PTR _x4$[esp+36], esi 
esi, DWORD PTR _a6$[esp+32] 
DWORD PTR _x7$[esp+32], ecx 
edx, esi 
edx, eax 
DWORD PTR _x6$[esp+36], edx 
edx, DWORD PTR _a3$[esp+32] 
edx, ebx 
ebx, esi 
ebx, DWORD PTR _a5$[esp+32] 
DWORD PTR _x8$[esp+36], edx 
ebx, edx 


ecx, edx 
edx, ebx 
edx, ebp 


edx, DWORD PTR _a6$[esp+32] 
ecx 

ecx, DWORD PTR _a6$[esp+32] 
edx, edi 

edi, edx 

edi, DWORD PTR _a2$[esp+32] 
DWORD PTR _x3$[esp+36], ebp 
ebp, DWORD PTR _a2$[esp+32] 
edi, ebx 

edi, DWORD PTR _al$[esp+32] 


, 


; 00000014H 
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mov 
xor 
not 
or 

xor 
mov 
mov 
xor 
not 
xor 
and 
mov 
mov 
or 

mov 
or 

mov 
xor 
mov 
xor 
not 
and 
mov 
and 
xor 
xor 
not 
mov 
and 
and 
xor 
mov 
xor 
xor 
mov 
mov 
and 
mov 
or 

mov 
not 
and 
or 

xor 
not 
and 
not 
or 

not 
and 
or 

xor 
mov 


ebx, ecx 

ebx, DWORD PTR _x7$[esp+32] 
edi 

ebx, ebp 

edi, ebx 

ebx, edi 

edi, DWORD PTR _out2$[esp+32] 
ebx, DWORD PTR [edi] 

eax 

ebx, DWORD PTR _x6$[esp+36] 
eax, edx 

DWORD PTR [edi], ebx 

ebx, DWORD PTR _x7$[esp+32] 
ebx, DWORD PTR _x6$[esp+36] 
edi, esi 

edi, DWORD PTR _x1$[esp+36] 
DWORD PTR _x28$[esp+32], ebx 
edi, DWORD PTR _x8$[esp+36] 
DWORD PTR  x24$[esp*32], edi 
edi, ecx 

edi 

edi, edx 

ebx, edi 

ebx, ebp 

ebx, DWORD PTR _x28$[esp+32] 
ebx, eax 

eax 

DWORD PTR _x33$[esp+32], ebx 
ebx, DWORD PTR _al$[esp+32] 
eax, ebp 

eax, ebx 

ebx, DWORD PTR _out4$[esp+32] 
eax, DWORD PTR [ebx] 

eax, DWORD PTR _x24$[esp+32] 
DWORD PTR [ebx], eax 

eax, DWORD PTR _x28$[esp+32] 
eax, DWORD PTR _a3$[esp+32] 
ebx, DWORD PTR _x3$[esp+36] 
edi, DWORD PTR _a3$[esp+32] 
DWORD PTR _x36$[esp+32], eax 
eax 

eax, edx 

ebx, ebp 

ebx, eax 

eax 

eax, DWORD PTR _x24$[esp+32] 
ebp 

eax, DWORD PTR _x3$[esp+36] 
esi 

ebp, eax 

eax, edx 

eax, DWORD PTR _a5$[esp+32] 
edx, DWORD PTR _x36$[esp+32] 
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xor edx, DWORD PTR _x4$[esp+36] 


xor ebp, edi 

mov edi, DWORD PTR _outl$[esp+32] 
not eax 

and eax, DWORD PTR _a2$[esp+32] 
not ebp 

and ebp, DWORD PTR _al$[esp+32] 
and edx, esi 

xor eax, edx 

or eax, DWORD PTR _al$[esp+32] 
not ebp 

xor ebp, DWORD PTR [edi] 

not ecx 

and ecx, DWORD PTR _x33$[esp+32] 
xor ebp, ebx 

not eax 

mov DWORD PTR [edi], ebp 

xor eax, ecx 


mov ecx, DWORD PTR _out3$[esp+32] 
xor eax, DWORD PTR [ecx] 


pop edi 
pop esi 
xor eax, ebx 
pop ebp 
mov DWORD PTR [ecx], eax 
pop ebx 
add esp, 20 
ret 0 
_sl ENDP 


5 variables were allocated in the local stack by the compiler. 
Now let’s try the same thing in the 64-bit version of MSVC 2008: 


Listing 1.400: Optimizing MSVC 2008 


al$ 
a2$ 


(0) 

w 

X 
uon wg al 

N 

N 


mov QWORD PTR [rsp+24], rbx 
mov QWORD PTR [rsp+32], rbp 
mov QWORD PTR [rsp+16], rdx 
mov QWORD PTR [rsp+8], rcx 
push rsi 
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push 
push 
push 
push 
push 
mov 
mov 
mov 
mov 
mov 
mov 
not 
xor 
not 
mov 
and 
mov 
mov 
and 
and 
and 
mov 
mov 
xor 
mov 
mov 
or 
not 
and 
mov 
and 
mov 
mov 
xor 
xor 
not 
and 
mov 
xor 
or 
xor 
and 
mov 
or 
xor 
mov 
xor 
and 
or 
not 
xor 
mov 
xor 


rdi 
r12 
r13 
r14 
r15 
r15, QWORD PTR a5$[rsp] 
rcx, QWORD PTR a6$[rsp] 


rbp, r8 

r10, r9 

rax, r15 
rdx, rbp 
rax 

rdx, r9 

r10 

rll, rax 
rax, r9 

rsi, r10 


QWORD PTR x36$1$[rsp], rax 
r11, r8 


rsi, r8 
r10, r15 
r13, rdx 
rbx, r11 
rbx, r9 
r9, QWORD PTR a2$[rsp] 
r12, rsi 
r12, r15 
r13 

r13, rcx 
r14, r12 
r14, rcx 
rax, r14 
r8, r14 
r8, rbx 
rax, r15 
rbx 

rax, rdx 
rdi, rax 
rdi, rsi 
rdi, rcx 
rdi, r10 
rbx, rdi 
rcx, rdi 
rcx, r9 
rcx, rax 
rax, r13 


rax, QWORD PTR x36$1$[rsp] 
rcx, QWORD PTR al$[rsp] 


rax, r9 
rcx 
rcx, rax 


rax, QWORD PTR out2$[rsp] 
rcx, QWORD PTR [rax] 
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xor 
mov 
mov 
mov 
or 

or 

mov 
xor 
mov 
mov 
mov 
xor 
not 
and 
mov 
and 
xor 
xor 
not 
and 
mov 
and 
xor 
mov 
xor 
xor 
mov 
mov 
and 
mov 
not 
and 
or 

mov 
xor 
not 
and 
or 

mov 
or 

xor 
mov 
not 
not 
not 
and 
or 

and 
xor 
xor 
mov 
not 
not 


rcx, r8 

QWORD PTR [rax], rcx 

rax, QWORD PTR x36$1$[rsp] 
rcx, r14 


rax, r8 
rcx, r11 
r11, r9 
rcx, rdx 


QWORD PTR x36$1$[rsp], rax 
r8, rsi 


rdx, rcx 
rdx, r13 
rdx 

rdx, rdi 
r10, rdx 
r10, r9 
r10, rax 
r10, rbx 
rbx 

rbx, r9 
rax, r10 
rax, QWORD PTR al$[rsp] 
rbx, rax 


rax, QWORD PTR out4$[rsp] 
rbx, QWORD PTR [rax] 

rbx, rcx 

QWORD PTR [rax], rbx 

rbx, QWORD PTR x36$1$[rsp] 


rbx, rbp 

r9, rbx 

r9 

r9, rdi 

r8, r11 

rax, QWORD PTR outi$[rsp] 
r8, r9 

r9 

r9, rcx 

rdx, rbp 

rbp, QWORD PTR [rsp+80] 
r9, rsi 

rbx, r12 

rcx, r11 

rcx 

r14 

r13 

rcx, r9 

r9, rdi 

rbx, r14 

r9, r15 

rcx, rdx 

rdx, QWORD PTR al$[rsp] 
r9 

rcx 
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and r13, r10 
and r9, r11 


and rcx, rdx 

xor r9, rbx 

mov rbx, QWORD PTR [rsp+72] 
not rcx 

xor rcx, QWORD PTR [rax] 

or r9, rdx 

not r9 

xor rcx, r8 


mov QWORD PTR [rax], rcx 
mov rax, QWORD PTR out3$[rsp] 


xor r9, r13 
xor r9, QWORD PTR [rax] 
xor r9, r8 
mov QWORD PTR [rax], r9 
pop r15 
pop r14 
pop r13 
pop r12 
pop rdi 
pop rsi 
ret 0 
sl ENDP 


Nothing was allocated in the local stack by the compiler, x36 is synonym for a5. 


By the way, there are CPUs with much more GPR’s, e.g. Itanium (128 registers). 


1.37.2 ARM 
64-bit instructions appeared in ARMv8. 


1.37.3 Float point numbers 


How floating point numbers are processed in x86-64 is explained here: 1.38 on the 
following page. 


1.37.4 64-bit architecture criticism 


Some people has irritation sometimes: now one needs twice as much memory for 
storing pointers, including cache memory, despite the fact that x64 CPUs can ad- 
dress only 48 bits of external RAM. 


Pointers have gone out of favor to the point now where | had to 
flame about it because on my 64-bit computer that | have here, if | re- 
ally care about using the capability of my machine | find that I'd better 
not use pointers because | have a machine that has 64-bit registers 
but it only has 2 gigabytes of RAM. So a pointer never has more than 
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32 significant bits to it. But every time | use a pointer it's costing me 
64 bits and that doubles the size of my data structure. Worse, it goes 
into the cache and half of my cache is gone and that costs cash—cache 
is expensive. 

So if I’m really trying to push the envelope now, | have to use arrays 
instead of pointers. | make complicated macros so that it looks like I’m 
using pointers, but I’m not really. 


( Donald Knuth in "Coders at Work: Reflections on the Craft of Programming ". ) 


Some people make their own memory allocators. It’s interesting to know about 
CryptoMiniSati?? case. This program rarely uses more than 4GiB of RAM, but it uses 
pointers heavily. So it requires less memory on 32-bit architecture than on 64-bit one. 
To mitigate this problem, author made his own allocator (in clauseallocator.(h|cpp) 
files), which allows to have access to allocated memory using 32-bit identifiers in- 
stead of 64-bit pointers. 


1.38 Working with floating point numbers using SIMD 
Of course, the FPU has remained in x86-compatible processors when the SIMD ex- 
tensions were added. 

The SIMD extensions (SSE2) offer an easier way to work with floating-point numbers. 
The number format remains the same (IEEE 754). 


So, modern compilers (including those generating for x86-64) usually use SIMD in- 
structions instead of FPU ones. 


It can be said that it's good news, because it's easier to work with them. 


We are going to reuse the examples from the FPU section here: 1.25 on page 275. 


1.38.1 Simple example 


#include <stdio.h> 

double f (double a, double b) 

: return a/3.14 + b*4.1; 

H 

int main() 

printf ("%f\n", f(1.2, 3.4)); 


180https://github.com/msoos/cryptominisat/ 
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x64 


Listing 1.401: Optimizing MSVC 2012 x64 


. reale4010666666666666 DQ 04010666666666666r ; 4.1 


. real40091eb851eb851f DQ 040091eb851eb851fr ; 3.14 
a$ = 8 

b$ = 16 

f PROC 


divsd xmm0, QWORD PTR _ real@40091eb851eb851f 
mulsd | xmm1, QWORD PTR _ real@4010666666666666 
addsd xmmO, xmml 
ret 0 

f ENDP 


The input floating point values are passed in the XMMO-XMM3 registers, all the rest—via 
the stack 18, 


a is passed in XMMO, b—via XMM1. 


The XMM-registers are 128-bit (as we know from the section about SIMD: 1.36 on 
page 513), but the double values are 64 bit, so only lower register half is used. 


DIVSD is an SSE-instruction that stands for "Divide Scalar Double-Precision Floating- 
Point Values", it just divides one value of type double by another, stored in the lower 
halves of operands. 


The constants are encoded by compiler in IEEE 754 format. 
MULSD and ADDSD work just as the same, but do multiplication and addition. 
The result of the function's execution in type double is left in the in XMMO register. 


That is how non-optimizing MSVC works: 


Listing 1.402: MSVC 2012 x64 


. reale4010666666666666 DQ 04010666666666666r ; 4.1 


. real40091eb851eb851f DQ 040091eb851eb851fr ; 3.14 
a$ = 8 

b$ = 16 

f PROC 


movsdx QWORD PTR [rsp+16], xmml 
movsdx QWORD PTR [rsp+8], xmm0 
movsdx xmm0, QWORD PTR a$[rsp] 
divsd xmm0, QWORD PTR  realQ40091eb851eb851f 
movsdx xmm1, QWORD PTR b$[rsp] 
mulsd xmm1, QWORD PTR  realQ4010666666666666 
addsd xmm0, xmml 
ret 0 
f ENDP 


181MSDN: Parameter Passing 
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Slightly redundant. The input arguments are saved in the "shadow space" (1.14.2 
on page 129), but only their lower register halves, i.e., only 64-bit values of type 
double. GCC produces the same code. 


x86 


Let's also compile this example for x86. Despite the fact it's generating for x86, 
MSVC 2012 uses SSE2 instructions: 


Listing 1.403: Non-optimizing MSVC 2012 x86 


tv70 = -8 ; size = 8 
_ag = 8 ; size = 8 
_b$ = 16 ; size = 8 
_f PROC 

push ebp 

mov ebp, esp 

sub esp, 8 


movsd xmm0, QWORD PTR _a$[ebp] 

divsd xmm0, QWORD PTR _ real@40091eb851eb851f 
movsd xmm1, QWORD PTR _b$[ebp] 

mulsd xmm1, QWORD PTR __real@4010666666666666 
addsd xmmO, xmml 

movsd QWORD PTR tv70[ebp], xmm0 


fld QWORD PTR tv70[ebp] 
mov esp, ebp 
pop ebp 
ret 0 
f ENDP 


Listing 1.404: Optimizing MSVC 2012 x86 


tv67 = 8 ; size = 8 

_a$ = 8 ; size = 8 

_b$ = 16 ; size = 8 
f PROC 


movsd xmm1, QWORD PTR a$[esp-4] 

divsd | xmm1, QWORD PTR _ real@40091eb851eb851f 
movsd xmm0, QWORD PTR _b$[esp-4] 

mulsd xmm0, QWORD PTR __real@4010666666666666 
addsd xmml, xmm0 

movsd QWORD PTR tv67[esp-4], xmml 


fld QWORD PTR tv67[esp-4] 
ret 0 
f ENDP 


It's almost the same code, however, there are some differences related to calling 
conventions: 1) the arguments are passed not in XMM registers, but in the stack, 
like in the FPU examples (1.25 on page 275); 2) the result of the function is returned 
in ST(0) — in order to do so, it's copied (through local variable tv) from one of the 
XMM registers to ST(0). 
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Let's try the optimized example in OllyDbg: 


main thread, module simple 


13320001 FLOAT 4.1888 
RDDSD Mi 


F20F58C8 ,WMna 
F20F114C24 & MOUSD GWORD PTR SS: CESP+4],xMM1 
DD4424 04 FED MORD PTR SS: [ESP+4] 


BL EEFEFEEF) 

aet 

D, WORD PTR DS: [13328081 FLOAT 3.40001 f GLFFEEFEFF) 
OLFFFFFFFF) 


vEFDDBaatFFF) 
MOUSD XMMO, QWORD PTR DS:L13328B81 FLOAT 1.20001 GS 6 t B(FFFFFFFF) 


cc 
F20F1005 Cool 
S3EC 18 SUB ESP, 1 


C 
F20F114424 2 MOUSD QUORD PTR SS:LESP*81, XMMO 
F2GF 1005 


F2@F 118424 | MOUSD QUORD PTR SS:CESP1,xNMG 
ES ADFFFFFF | CALL 61331900 
ODSC24 08 FSTP QUORD PTR SS: [ESP+8] 


ADD ESP,8 

PUSH OFFSET 01333000 ASCII "Zzfg" 
CALL DWORD PTR DS: [<eMSUCR118.printf>1 
ADD ESP, ØC 

XOR EAX, EAX 

RETN 


à ERRO 
(NO, NB, HE, A, NS 


empty 
empty 
empty & 


INTS 

MOU ERX,SR4D 

9908: CHP WORD PTR DS: [<STRUCT IMAGE DOS HERDI 
JE SHORT 81331882 

XOR EAX, EAX 

JMP SHORT 01331086 

MOU ECX, DWORD PTR DS: [1330030] 

CMP DWORD PTR DS:[ECX+<STRUCT IMAGE_DOS] 
75 EA JNE SHORT 60133107E 
a BS 6BO10000_ |MOU EAX, 10B 
La13328C81-3. 14 


a 
XMMI=O. 0, 1.200000000000000 


ø DZ Ø Err 
Mask 


RETURN from simple.01331030 to simple. 013 


Pointer to next SEH record 
E handler 


Figure 1.113: OllyDbg: MOVSD loads the value of a into XMM1 
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CPU - main thread, module simple 
F20F104C24 &à«MOUSD XMM1,QUORD PTR leg F 
F20FSEOD Cael DIUSD XMM1, WORD PTR 1400 : SUFRE 
F20F10 MOUSD XMMO, QUORD PTR SS: [ESP+0C] ~ = : 
F20F5995 Dae MULSD XMMO,QWORD PTR DS: [1332000] 
F20F58C8 RDDSD XMM1,XMMAO 
F20F114C24 Ø| MOUSD QUORD_PTR SS: [ESP+4],XMM1 FBC 
DD4424 64 [FLO QUORD PTR SS: CESP+4] O L7FCLO 
RETN SI 80000081 
OOGAI 


060133100E simple. 00133100E 


cc INTS O(FFFFFFFF) 
3 B(FFFFFFFF) 

F20F 1005 CB2lMOUSD XMMG, QWORD PTR DS: [1332008] FLOAT 3.49001 BLFFFFFFFF) 

83EC 10 SUB ESP, 18 B GL EFEFFFFF) 

F20F114424 Øi MOUSD QUORD PTR SS: CESP+81, XxMMO $6 E SED OACECF) 

FSor loge Beal MOUSD XMM, GORD PTR DS: [1232068] FLOAT 1.20001 RS 8 t OCFEEPEEEF) 

F28F110424 '|MOUSD QWORD PTR SS: CESPI, xMMa j i 

ES RDFFFFFF |CALL 01331000 

DDSC24 98 | FSTP_QWORD PTR SS: [ESP+81 


ADD ESP,8 
PUSH OFFSET 01333000 ASCII "zfg" B empty 
GALL WORD PTR DS: C<&MSUCR116. printf >] STi empty 


HDD ESP, ØC : 
XOR EAX, EAX eon 
RETN 


LastErr 
9a000202 
4.8 


"pty 
empty 
5 empty 
empty @ 
3 J Z DI 
oa o 3 a Ø (GT) 


MOU EAX, SA40 
2009 CMP WORD PTR DS:[<STRUCT IMAGE_DOS_HEADI cmnd BAHA 
JE SHORT 01331082 m 
XOR EAX, EAX 


JMP SHORT 01331086 

MOU ECX, DWORD PTR DS: [1330030] 
CMP DWORD PTR DS: CECX+<STRUCT IMAGE_DOS] 
500 a 60199107E 


Stack TOBI?FECCI=3. 4oa990000000 
AMMO=0.0, 1.20800000060060000 
R @BBG1FAG FZ ð DZ 
Rnd NEAR 


RETURN from simple.01331030 to simple. 013 


cooooco 
bb 


DOS 
m OOmoocoom 


Ooososoo 


Pointer to next SEH record 
SE handler 


boo 
boo 


66 Ci 
aaterCcos 


GOGOOOO0099999os| 


boooooooooooo 


Figure 1.114: OllyDbg: DIVSD calculated quotient and stored it in XMM1 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


j CPU - - main thread, module simple. 


FLOAT 3.1488 
ESP+8C] 
13320081 POT 4. 10001 


RDDSD XMM1,xNNG LORT 8.8, 1: 
MOUSD GUORD PTR SS: LESP*41, XMM1 
FED MORD PTR SS: [ESP+4] 


— initenv 


OC FFFFFFFF) 


ce 
FoF 1906 cael noveo "MG, QUORD PTR DS: [1332008 FLOAT 3.4800 MEE 


SUB ESP; OLFFFFFFFF) 
E20F114424 al HOUSD RÍDRD PTR SS: [ESP«G, XO : BIEEEREEFEL 
FSor loge Beal MOUSD XMM, GORD PTR DS: [1232068] FLOAT 1.20001 HE papa Mas 
F20F110424  |MOUSD QUORD PTR SS: LESPJ,XMMO E m 

EB ADFFFFFF | CALL 01331008 LastErr 
ODSC24 08 FSTP_QUORD PTR SS: [ESP+8] = 


ADD ESP, 8 00000202 
PUSH OFFSET 01333000 ASCII "zfg" B empty 0.0 
CALL DWORD PTR DS: [<2MSUCR110.printf>] STi empty 8. 
ADD ESP, ØC empty O. 
XOR EAX, EAX 
RETN ptu 
enpty 
6 empty 
empty O 
3 Z DI 
aano O 3 a a Ø (GT) 


MOU EAX, 5A4D Gore Pe 11 
m6 of Sofas IKSTRUCT IHRGE DOS HERD P nd 9000: 0000 

so ; ,13:24000000000000 
SHE SHORT 01991086 4 


MOU ECX, DWORD PTR DS:L133883C1 Te aaa 1A 
CMP DWORD PTR OS:CECX+<STRUCT IMRGE. DOS| nme a. 
JNE SHORT @133107E 


Fe @ DZ 
Rnd NEAR 


RETURN from simple.01331039 to simple.013 


cooooco 
bb 


DOS 
m OOmoocoom 


Ooososoo 


Pointer to next SEH record 
SE handler 


© 
© 


GOGOOOO0099999os| 
bo c 
bo: 


boooooooooooo 


ool; FCOS 


Figure 1.115: OllyDbg: MULSD calculated product and stored it in XMMO 
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CPU - main thread, module simple 


ESP+4] 

1332000] FLOAT 3.1400 

ESP+0C] 

13320001 FLOAT 4.16886 
F20F58C8 
F20F114C24 FLOAT 8.8, 1: 
eee @B17FC18 

E 

aenaeaan 
01331020 sinple.01331020 


ce INTS G(FEFFFFFF) 
E20F 1995 CO NOUSD Nro, WORD PTR DS: [1332081 FLOAT 3.4800 a cent IO LEER RETOS 
F20F114424 Øi MOUSD QUORD PTR SS: [ESP+87,XMM E cda 
Foor lage Baci HDUSD RING, OWRD PTR DS: [12320681 FLOAT 1.20001 = Ges pat Ma 
F20F110424- | MOUSD_QUORD PTR SS: CESPI,XMMO 

ES ADFFFEFF |CALL 91331000 REN 
DDsC24 68 | FSTP_GUORD PTR SS: [ESP+8] : 


ADD ESP,8 00000202 (NO,NB,NE,A,NS,PO,GE,G) 
PUSH OFFSET 01333000 ASCII "zfg" empty 8.8 
CALL DWORD PTR DS: [<eMSUCR118.printf>1 = v» 8.0 


ADD ESP, aC 
XOR EAX, EAX 
RETN 


? empty 


> s 2DI 
MOU EAX, 5a4D Soe. ond on 9.9. (gr? 
Baal CHP WORD PTR DS:L«STRUCT IHRE DOS HERD ; 2 

2 ? 3. 940009090090090 
JMP SHORT 61331086 x 
MOY ECX, DWORD PTR DS:r133003C1 : E 
CHP DWORD PTR DS:CECK+<STRUCT IMAGE DOS| : 

JNE SHORT @193107E 

es üBe10000 | MOU EAX, 108 


XMMI-B.D, 14.32216560509554 
Stack LG617FBC41-1.200000000000000 


Q@G0G1FAG FZ Ø DZ Err 
Rnd NEAR Mask 
N s 
aa BB 
aa ao 


(a 
RETURN from simple.01331030 to simple.013 


0017FEFO 
7FBF4 


Pointer to next SEH record 
B| SE handler 


Figure 1.116: OllyDbg: ADDSD adds value in XMMO to XMM1 
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F20F104024 87 MOUSD XMMI,QUORD PTR 55: [ESP+4] 

DIUSD XHMI,QUORD PTR DS: [13320091 FLORT 3.1480 q CRILO. In itenv 
MOUSD XHMA; QWORD PTR SS: [ESP+8C] ii 
MULSD XHMA, QUORD PTR DS: [13320091 FLOAT 4. 1000 
5 RDDSD XMM1, XMMØ 
F20F114C24 Ø| MOUSD QUDRD PTR SS:CESP+41,XMM1 
DD4g24 G4 [ELO SWORD PTR SS: TESP+41 


> B133102A 
ES Ø 


cc IN 

F2GF1005 CS2| MOUSO_XMMG,QWORD PTR DS: [1332008] FLOAT 3.49001 

SSEC 18 SUB ESP, 18 

F20F114424 01 MOUSD GWIORD PTR SS:CESP+81, XMMG 1a sia zs d M 

F20F 109e Esel MOUSD RHHOLQNORD PTR DS: [15320881 FLOAT 1.20001 EEDE LEE 

F2üF118424 -|MOUSD GWORD PTR SS: [ESP], XMMG a 
CALL 81331000 ER 

FSTP QUORD PTR SS: [ESP+8] k 

PUSH OFFSET 01333000 ASCII "Eg" à E 

CALL DORD PTR DS: [<&MSUCR110.printf>] valid 14.90 105609899899999 


IN “€ e 
CHP WORD PTR_DS:C<STRUCT IMRGE DOS. HERD F NEOR, : 
CHP WORD PTR OSs nd 8023: 01381026 
XOR EAX, EAX 

SHORT B1331086 

ECX, DWORD PTR DS: [13309301 

DUORD PTR DS:CECK+<STRUCT IMRGE DOS. 

SHORT _B133107E 

EAX, 108 


simple.£ 


1FAG F2 8 DZ a 
Rnd NERR 


RETURN from simple.@1331938 to simple.813 


Pointer to next SEH re 
E handler 


Figure 1.117: OllyDbg: FLD left function result in ST(0) 


We see that OllyDbg shows the XMM registers as pairs of double numbers, but only 
the lower part is used. 


Apparently, OllyDbg shows them in that format because the SSE2 instructions (suf- 
fixed with -SD) are executed right now. 


But of course, it's possible to switch the register format and to see their contents as 
4 float-numbers or just as 16 bytes. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


549 


1.38.2 Passing floating point number via arguments 


#include <math.h> 
#include <stdio.h> 


int main () 
{ 
printf ("32.01 ^ 1.54 = %lf\n", pow (32.01,1.54)); 


return 0; 


They are passed in the lower halves of the XMM0-XMM3 registers. 
Listing 1.405: Optimizing MSVC 2012 x64 


$5G1354 DB '32.01 ^ 1.54 = %lf', OaH, OOH 
__real@40400147ael47ael DQ 040400147ae147aelr ; 32.01 
. realQ3ff8a3d70a3d70a4 DQ 03ff8a3d70a3d70a4r ; 1.54 
main PROC 
sub rsp, 40 ; 00000028H 


movsdx xmm1, QWORD PTR _ real@3ff8a3d70a3d70a4 
movsdx xmm0, QWORD PTR _ real@40400147ae147ael 


call pow 
lea rcx, OFFSET FLAT: $SG1354 
movaps xmml, xmmO 
movd rdx, xmml 
call printf 
xor eax, eax 
add rsp, 40 ; 00000028H 
ret 0 
main ENDP 


There is no MOVSDX instruction in Intel and AMD manuals (12.1.4 on page 1282), there 
it is called just MOVSD. So there are two instructions sharing the same name in x86 
(about the other see: .1.6 on page 1300). Apparently, Microsoft developers wanted 
to get rid of the mess, so they renamed it to MOVSDX. It just loads a value into the 
lower half of a XMM register. 


pow() takes arguments from XMMO and XMM1, and returns result in XMMO. It is then 
moved to RDX for printf(). Why? Maybe because printf()—is a variable argu- 
ments function? 


Listing 1.406: Optimizing GCC 4.4.6 x64 


.LC2: 
.string "32.01 ^ 1.54 = %lf\n" 
main: 
sub rsp, 8 
movsd xmm1, QWORD PTR .LCO[rip] 
movsd xmm0, QWORD PTR .LC1[rip] 
call pow 
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; result is now in XMMO 


mov edi, OFFSET FLAT:.LC2 
mov eax, 1 ; number of vector registers passed 
call printf 
xor eax, eax 
add rsp, 8 
ret 
.LC0: 
.long 171798692 
. Long 1073259479 
.LC1: 


.long 2920577761 
.long 1077936455 


GCC generates clearer output. The value for printf() is passed in XMMO. By the way, 
here is a case when 1 is written into EAX for printf()—this implies that one argu- 
ment will be passed in vector registers, just as the standard requires [Michael Matz, 
Jan Hubicka, Andreas Jaeger, Mark Mitchell, System V Application Binary Interface. 
AMD64 Architecture Processor Supplement, (2013)] 182. 


1.38.3 Comparison example 


#include <stdio.h> 


double d max (double a, double b) 


1 

if (a»b) 

return a; 

return b; 
$; 
int main() 
1 

printf ("%f\n", d max (1.2, 3.4)); 

printf ("%f\n", d max (5.6, -4)); 
$; 
x64 

Listing 1.407: Optimizing MSVC 2012 x64 

a$ = 8 
b$ = 16 
d max PROC 

comisd xmm0, xmml 

ja SHORT $LN2@d_max 

movaps xmm0, xmml 
$LN2Gd max: 


182Also available as  https://software.intel.com/sites/default/files/article/402129/ 
mpx- Linux64- abi. pdf 
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fatret 0 
d max X ENDP 


Optimizing MSVC generates a code very easy to understand. 
COMISD is "Compare Scalar Ordered Double-Precision Floating-Point Values and Set 
EFLAGS". Essentially, that is what it does. 


Non-optimizing MSVC generates more redundant code, but it is still not hard to un- 
derstand: 


Listing 1.408: MSVC 2012 x64 


a$ = 8 

b$ = 16 

d max PROC 
movsdx QWORD PTR [rsp+16], xmm1 
movsdx QWORD PTR [rsp+8], xmm0 
movsdx xmm0, QWORD PTR a$[rsp] 
comisd xmm0, QWORD PTR b$[rsp] 
jbe SHORT $LN1Gd max 
movsdx xmm0, QWORD PTR a$[rsp] 
jmp SHORT $LN2Gd max 

$LN1Gd max: 
movsdx xmm0, QWORD PTR b$[rsp] 

$LN2Gd max: 
fatret 0 

d max  ENDP 


However, GCC 4.4.6 did more optimizations and used the MAXSD ("Return Maximum 
Scalar Double-Precision Floating-Point Value") instruction, which just choose the max- 
imum value! 


Listing 1.409: Optimizing GCC 4.4.6 x64 


d max: 
maxsd xmmO, xmml 
ret 
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x86 


Let's compile this example in MSVC 2012 with optimization turned on: 


Listing 1.410: Optimizing MSVC 2012 x86 


_ag = 8 

_b$ = 16 

_d max PROC 
movsd 
comisd 
jbe 
fld 
ret 

$LN1@d_max: 
fld 
ret 

.d max ENDP 


8 
8 


; Size 
; Size 


xmm0, QWORD PTR _a$[esp-4] 
xmm0, QWORD PTR _b$[esp-4] 
SHORT $LN1@d_max 

QWORD PTR a$[esp-4] 

0 


QWORD PTR _b$[esp-4] 
0 


Almost the same, but the values of a and b are taken from the stack and the function 
result is left in ST(0). 


If we load this example in OllyDbg, we can see how the COMISD instruction compares 
values and sets/clears the CF and PF flags: 
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CPU - main thread, module d max 


5 


> 


F20F104424 à 
660F2F4424 à 


ovr 76 


BS 
[So 04 
DD4424 BC 
c3 


cc 

F20F1005 Cae 
Fe0F114424 0 
F20F1005 pae 
F20F110424 

ES BDFFFFFF 
ODSC24 08 


FF15 36 eal 
case 


F20F114424 3 


Jump is taken 


Dest=d_max. Ø 


0821013 


MOUSD XMMO, QWORD PTR SS:[ARG. 1] 
COMISD XMMO, QWORD PTR SS:[ARG.3] 


JBE SHORT 98821613 
FLD QWORD PTR SS:CARG.1] 


D_2MMO,QUORD PTR DS: [322000] 
SUB ESP, 10 
MOUSD QWORD PTR SS: [LOCAL.1],2MM0 
MOUSD XMMØ, QWORD PTR DS: [322088] 
MOUSD QWORD PTR SS: [LOCAL.3],XMM0 
CALL 00821000 
FSTP_QUORD PTR SS:CLOCAL.1] 
ADD ESP, 8 
PUSH OFFSET 00823000 
CALL DWORD PTR DS:L4&HSUCR118.printf?1 
MOUSD_XMMO, QWORD PTR DS:L82280D681 
PUSH ECX 
MOUSD QWORD PTR SS: CLOCAL.1],XMNG 
MOUSD XMMO, QWORD PTR DS: (822603) 
MOUSD QWORD PTR SS: [LOCAL.3],2MM0 
CALL 00821000 
FSTP_QWORD PTR SS:CLOCAL.1] 
ADD ESP, 


PUSH OFFSET 00823004 

CALL DWORD PTR DS: (<&MSUCR11@.printf>] 
ADD ESP, 0C 

XOR ERX,ERX 

RETN 

INT. 

INT. 


SEU EAN SED nA 


FFFFFFFF) 
GCFFFFFFFF) 
Q(FFFFFFFF) 
GU FFFFFFFF) 
7EFDDGG8( FFF) 
@(FFFFFFFF) 


LastErr 400 


00000203 iNO, B, NE, BE, N 


empty 
empty 
mpty 
mpty 
mpty 
mpty 
mpty 
empty 


a 
2 
> 


DI 
8 8 (GT) 


FZ Ø DZ @ 
Rnd NEAR 


RETURN from d mas. 00821020 to d mas.t 


Figure 1.118: OllyDbg: COMISD changed CF and PF flags 


1.38.4 Calculating machine epsilon: x64 and SIMD 


Let's revisit the "calculating machine epsilon" example for double listing.1.32.2. 


Now we compile it for x64: 


Listing 1.411: Optimizing MSVC 2012 x64 


v$ = 8 


calculate machine epsilon PROC 


movsdx 
movaps 
inc 
movsdx 
subsd 
ret 


QWORD 
xmml, 
QWORD 
xmm0, 
xmm0, 
0 


PTR v$[rsp], xmm0 
xmm0 

PTR v$[rsp] 

QWORD PTR v$[rsp] 
xmm1 


calculate machine epsilon ENDP 


There is no way to add 1 to a value in 128-bit XMM register, so it must be placed into 


memory. 


There is, however, the ADDSD instruction (Add Scalar Double-Precision Floating-Point 
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Values) which can add a value to the lowest 64-bit half of a XMM register while 
ignoring the higher one, but MSVC 2012 probably is not that good yet 183., 


Nevertheless, the value is then reloaded to a XMM register and subtraction occurs. 
SUBSD is "Subtract Scalar Double-Precision Floating-Point Values", i.e., it operates 
on the lower 64-bit part of 128-bit XMM register. The result is returned in the XMMO 
register. 


1.38.5 Pseudo-random number generator example revisited 


Let's revisit “pseudo-random number generator example" example listing.1.32.1. 
If we compile this in MSVC 2012, it will use the SIMD instructions for the FPU. 


Listing 1.412: Optimizing MSVC 2012 


. reale3f800000 DD 03f800000r  Á; 1 


tv128 -4 
_tmp$ = -4 
?float_rand@@YAMXZ PROC 
push ecx 
call ?my_rand@@YAIXZ 
; EAX=pseudorandom value 
and eax, 8388607 ; 007fffffH 
or eax, 1065353216 ; 3f800000H 
EAX=pseudorandom value € 0x007fffff | Ox3f800000 
store it into local stack: 
mov DWORD PTR tmp$[esp-4], eax 
reload it as float point number: 
movss  xmm0, DWORD PTR _tmp$[esp+4] 
subtract 1.0: 
subss  xmm0, DWORD PTR _ real@3f800000 
; move value to STO by placing it in temporary variable... 
movss DWORD PTR tv128[esp+4], xmm0 
; o... and reloading it into STO: 


fld DWORD PTR tv128[esp+4] 
pop ecx 
ret 0 


?float_rand@@YAMXZ ENDP 


All instructions have the -SS suffix, which stands for “Scalar Single". 
“Scalar” implies that only one value is stored in the register. 
“Single”*9* stands for float data type. 


1.38.6 Summary 


Only the lower half of XMM registers is used in all examples here, to store number 
in IEEE 754 format. 


183As an exercise, you may try to rework this code to eliminate the usage of the local stack. 
184| .e., single precision. 
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Essentially, all instructions prefixed by -SD ("Scalar Double-Precision")—are instruc- 
tions working with floating point numbers in IEEE 754 format, stored in the lower 
64-bit half of a XMM register. 


And it is easier than in the FPU, probably because the SIMD extensions were evolved 
in a less chaotic way than the FPU ones in the past. The stack register model is not 
used. 


If you would try to replace double with float 


in these examples, the same instructions will be used, but prefixed with -SS ("Scalar 
Single-Precision"), for example, MOVSS, COMISS, ADDSS, etc. 


"Scalar" implies that the SIMD register containing only one value instead of several. 


Instructions working with several values in a register simultaneously have "Packed" 
in their name. 


Needless to say, the SSE2 instructions work with 64-bit IEEE 754 numbers (double), 
while the internal representation of the floating-point numbers in FPU is 80-bit num- 
bers. 


Hence, the FPU may produce less round-off errors and as a consequence, FPU may 
give more precise calculation results. 


1.39 ARM-specific details 


1.39.1 Number sign (#) before number 


The Keil compiler, IDA and objdump precede all numbers with the “+” number sign, 
for example: listing.1.22.1. 


But when GCC 4.9 generates assembly language output, it doesn't, for example: 
listing.3.18. 


The ARM listings in this book are somewhat mixed. 


It's hard to say, which method is right. Supposedly, one has to obey the rules ac- 
cepted in environment he/she works in. 


1.39.2 Addressing modes 
This instruction is possible in ARM64: 


ldr x0, [x29,24] 


This means add 24 to the value in X29 and load the value from this address. 


Please note that 24 is inside the brackets. The meaning is different if the number is 
outside the brackets: 


ldr w4, [x1],28 
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This means load the value at the address in X1, then add 28 to X1. 
ARM allows you to add or subtract a constant to/from the address used for loading. 
And it's possible to do that both before and after loading. 


There is no such addressing mode in x86, but it is present in some other processors, 
even on PDP-11. 


There is a legend that the pre-increment, post-increment, pre-decrement and post- 
decrement modes in PDP-11, were "guilty" for the appearance of such C language 
(which developed on PDP-11) constructs as *ptr++, *++ptr, *ptr--, *--ptr. 


By the way, this is one of the hard to memorize C features. This is how it is: 


C term ARM term C statement | how it works 
Post-increment | post-indexed addressing | *ptr++ use *ptr value, 

then increment 

ptr pointer 
Post-decrement | post-indexed addressing | *ptr-- use *ptr value, 

then decrement 

ptr pointer 
Pre-increment pre-indexed addressing *++ptr increment ptr pointer, 
then use 

*ptr value 
Pre-decrement | pre-indexed addressing *--ptr decrement ptr pointer, 
then use 

*ptr value 


Pre-indexing is marked with an exclamation mark in the ARM assembly language. 
For example, see line 2 in listing.1.29. 


Dennis Ritchie (one of the creators of the C language) mentioned that it presumably 
was invented by Ken Thompson (another C creator) because this processor feature 
was present in PDP-7 185, [Dennis M. Ritchie, The development of the C language, 
(1993)]***. 


Thus, C language compilers may use it, if it is present on the target processor. 
That's very convenient for array processing. 


1.39.3 Loading a constant into a register 
32-bit ARM 


As we already know, all instructions have a length of 4 bytes in ARM mode and 2 
bytes in Thumb mode. 


Then how can we load a 32-bit value into a register, if it's not possible to encode it 
in one instruction? 


Let's try: 


185http://yurichev.com/mirrors/C/c_dmr postincrement.txt 
186 Also available as pdf 
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unsigned int f() 


1 

return 0x12345678; 
ur 

Listing 1.413: GCC 4.6.3 -03 ARM mode 

f: 

ldr ro, .L2 

bx lr 
.L2: 


.word 305419896 ; 0x12345678 


So, the 0x12345678 value is just stored aside in memory and loaded if needed. 


But it's possible to get rid of the additional memory access. 


Listing 1.414: GCC 4.6.3 -03 -march=armv7-a (ARM mode) 


movw ro, #22136 ; 0x5678 
movt rO, #4660 ; 0x1234 
bx lr 


We see that the value is loaded into the register by parts, the lower part first (using 
MOVW), then the higher (using MOVT). 


This implies that 2 instructions are necessary in ARM mode for loading a 32-bit value 
into a register. 


It’s not a real problem, because in fact there are not many constants in real code 
(except of O and 1). 


Does it mean that the two-instruction version is slower than one-instruction version? 


Doubtfully. Most likely, modern ARM processors are able to detect such sequences 
and execute them fast. 


On the other hand, IDA is able to detect such patterns in the code and disassembles 
this function as: 


MOV RO, 0x12345678 


BX LR 
ARM64 
uint64 t f() 
1 

return 0x12345678ABCDEF01 ; 
ur 

Listing 1.415: GCC 4.9.1 -O3 

mov x0, 61185 ; Oxef01 
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movk x0, Oxabcd, 1sl 16 
movk x0, 0x5678, lsl 32 
movk x0, 0x1234, lsl 48 
ret 


MOVK stands for "MOV Keep", i.e., it writes a 16-bit value into the register, not touch- 
ing the rest of the bits. The LSL suffix shifts left the value by 16, 32 and 48 bits at 
each step. The shifting is done before loading. 


This implies that 4 instructions are necessary to load a 64-bit value into a register. 
Storing floating-point number into register 
It's possible to store a floating-point number into a D-register using only one instruc- 


tion. 


For example: 


double a() 
1 

return 1.5; 
ur 


Listing 1.416: GCC 4.9.1 -03 + objdump 


0000000000000000 «a»: 
0: 1e6f1000 fmov dO, #1.500000000000000000e+000 
4: d65f03c0 ret 


The number 1.5 was indeed encoded in a 32-bit instruction. But how? 


In ARM64, there are 8 bits in the FMOV instruction for encoding some floating-point 
numbers. 


The algorithm is called VFPExpandImm() in [ARM Architecture Reference Manual, 
ARMV8, for ARMv8-A architecture profile, (2013)]197. This is also called minifloat**?. 


We can try different values: the compiler is able to encode 30.0 and 31.0, but it 
couldn't encode 32.0, as 8 bytes have to be allocated for this number in the IEEE 
754 format: 


double a() 
1 
return 32; 
F 
Listing 1.417: GCC 4.9.1 -03 
a: 


187Also available as http://yurichev.com/mirrors/ARMv8-A Architecture Reference Manual _ 
(Issue A.a).pdf 
188wikipedia 
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ldr dQ, .LCO 
ret 
.LC0: 
.word 0 
.word 1077936128 


1.39.4 Relocs in ARM64 
As we know, there are 4-byte instructions in ARM64, so it is impossible to write a 
large number into a register using a single instruction. 


Nevertheless, an executable image can be loaded at any random address in memory, 
so that's why relocs exists. Read more about them (in relation to Win32 PE): 6.5.2 
on page 967. 


The address is formed using the ADRP and ADD instruction pair in ARM64. 


The first loads a 4KiB-page address and the second one adds the remainder. Let's 
compile the example from "Hello, world!" (listing.1.11) in GCC (Linaro) 4.9 under 
win32: 
Listing 1.418: GCC (Linaro) 4.9 and objdump of object file 
..»aarch64-linux-gnu-gcc.exe hw.c -C 


. >aarch64-linux-gnu-objdump.exe -d hw.o 


0000000000000000 <main>: 


0: a9bf7bfd stp x29, x30, [sp,£-16]! 
4: 910003fd mov x29, sp 

8: | 90000000 adrp x0, 0 «main» 

c: | 91000000 add x0, x0, #0x0 

10: | 94000000 bl 0 <printf> 

14: 52800000 mov wO, #0x0 // #0 

18: a8c17bfd ldp x29, x30, [sp],#16 
lc: d65f03c0 ret 


. >aarch64-linux-gnu-objdump.exe -r hw.o 


RELOCATION RECORDS FOR [.text]: 
OFFSET TYPE VALUE 
0000000000000008 R AARCH64 ADR PREL PG HI21 .rodata 
000000000000000c R AARCH64 ADD ABS L012 NC .rodata 
0000000000000010 R AARCH64 CALL26 printf 


So there are 3 relocs in this object file. 


* The first one takes the page address, cuts the lowest 12 bits and writes the 
remaining high 21 bits to the ADRP instruction's bit fields. This is because we 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


560 
don't need to encode the low 12 bits, and the ADRP instruction has space only 
for 21 bits. 


The second one puts the 12 bits of the address relative to the page start into 
the ADD instruction's bit fields. 


The last, 26-bit one, is applied to the instruction at address 0x10 where the 
jump to the printf() function is. 


All ARM64 (and in ARM in ARM mode) instruction addresses have zeros in the 
two lowest bits (because all instructions have a size of 4 bytes), so one have to 
encode only the highest 26 bits of 28-bit address space (+128MB). 


There are no such relocs in the executable file: because it's known where the "Hello!" 
string is located, in which page, and the address of puts() is also known. 


So there are values set already in the ADRP, ADD and BL instructions (the linker has 
written them while linking): 


Listing 1.419: objdump of executable file 


0000000000400590 <main>: 


400590: a9bf7bfd stp x29, x30, [sp,£-16]! 
400594: 910003fd mov x29, sp 

400598: 90000000 adrp x0, 400000 < init-0x3b8» 
40059c: 91192000 add x0, x0, #0x648 

400590: 97ffffa0 bl 400420 <puts@plt> 
4005234: 52800000 mov wO, #0x0 // #0 

4005a8: a8c17bfd ldp x29, x30, [sp],#16 
4005ac: d65f03c0 ret 


Contents of section .rodata: 
400640 01000200 00000000 48656c6c 6f210000 ........ Hello!.. 


As an example, let's try to disassemble the BL instruction manually. 

0x97ffffaO0 is 0610010111111111111111111110100000. According to [ARM Architecture 
Reference Manual, ARMv8, for ARMv8-A architecture profile, (2013)C5.6.26], imm26 
is the last 26 bits: 

imm26 = 0b11111111111111111110100000. It is Ox3FFFFAO0, but the MSB is 1, so the 
number is negative, and we can convert it manually to convenient form for us. 
By the rules of negation, just invert all bits: (it is O0b1011111=0x5F), and add 1 
(0x5F+1=0x60). So the number in signed form is -0x60. Let's multiply -0x60 by 4 
(because address stored in opcode is divided by 4): itis -0x180. Now let's calculate 
destination address: 0x4005a0 + (-0x180) = 0x400420 (please note: we consider 
the address of the BL instruction, not the current value of PC, which may be differ- 
ent!). So the destination address is 0x400420. 


More about ARM64-related relocs: [ELF for the ARM 64-bit Architecture (AArch64), 
(2013)]182, 


189A|lso available as http://infocenter.arm.com/help/topic/com.arm.doc.ihi0056b/IHI0056B 
aaelf64.pdf 
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1.40 MIPS-specific details 


1.40.1 Loading a 32-bit constant into register 


unsigned int f() 


{ 
F; 


return 0x12345678; 


All instructions in MIPS, just like ARM, have a size of 32-bit, so it's not possible to 
embed a 32-bit constant into one instruction. 


So one have to use at least two instructions: the first loads the high part of the 32-bit 
number and the second one applies an OR operation, which effectively sets the low 
16-bit part of the target register: 


Listing 1.420: GCC 4.4.5 -03 (assembly output) 


li $2,305397760 # 0x12340000 
j $31 
ori $2,$2,0x5678 ; branch delay slot 


IDA is fully aware of such frequently encountered code patterns, so, for convenience 
it shows the last ORI instruction as the LI pseudo instruction, which allegedly loads 
a full 32-bit number into the $VO register. 


Listing 1.421: GCC 4.4.5 -O3 (IDA) 


lui $v0, 0x1234 
jr $ra 
li $v0, 0x12345678 ; branch delay slot 


The GCC assembly output has the LI pseudo instruction, but in fact, LUI (“Load Upper 
Immediate") is there, which stores a 16-bit value into the high part of the register. 


Let's see in objdump output: 


Listing 1.422: objdump 


00000000 <f>: 


0: 3c021234 lui v0,0x1234 
4: 03e00008 jr ra 
8: 34425678 ori v0,v0,0x5678 


Loading a 32-bit global variable into register 


unsigned int global varz0x12345678; 


unsigned int f2() 
1 


return global var; 
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This is slightly different: LUI loads upper 16-bit from global var into $2 (or $VO) and 
then LW loads lower 16-bits summing it with the contents of $2: 


Listing 1.423: GCC 4.4.5 -O3 (assembly output) 


f2: 
lui $2,*shi(global var) 
lw $2,%lo(global_var) ($2) 
j $31 
nop ; branch delay slot 
global var: 


.word 305419896 


IDA is fully aware of often used LUI/LW instruction pair, so it coalesces both into a 
single LW instruction: 


Listing 1.424: GCC 4.4.5 -O3 (IDA) 


T2: 
lw $v0, global var 
jr $ra 
or gat, $zero ; branch delay slot 
.data 
.globl global var 
global var: .word 0x12345678 X DATA XREF: f2 


objdump's output is the same as GCC's assembly output. Let's also dump relocs of 
the object file: 


Listing 1.425: objdump 


objdump -D filename.o 


0000000c <f2>: 


C: 3c020000 lui v0,0x0 
10: 8c420000 lw v0,0(v0) 
14: 03e00008 jr ra 
18: 00200825 move at,at ; branch delay slot 
1c: 00200825 move at,at 


Disassembly of section .data: 


00000000 «global var»: 
0: 12345678 beq s1,s4,159e4 <f2+0x159d8> 
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objdump -r filename.o 


RELOCATION RECORDS FOR [.text]: 


OFFSET TYPE VALUE 
0000000c R MIPS HI16 global var 
00000010 R MIPS L016 global var 


We can see that address of global var is to be written right into LUI and LW instruc- 
tions during executable file loading: high 16-bit part of global var goes into the first 
one (LUI), lower 16-bit part goes into the second one (LW). 

1.40.2 Further reading about MIPS 


Dominic Sweetman, See MIPS Run, Second Edition, (2010). 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Chapter 2 


Important fundamentals 


Mathematical Recipes*has some important notes about boolean algebra and signed 
numbers representation. 


2.1 Integral datatypes 


Integral datatype is a type for a value which can be converted to number. These are 
numbers, enumerations, booleans. 


2.1.1 Bit 


Obvious usage for bits are boolean values: O for false and 1 for true. 


Set of booleans can be packed into word: there will be 32 booleans in 32-bit word, 
etc. This way is called bitmap or bitfield. 


But it has obvious overhead: a bit jiggling, isolating, etc. While using word (or int 
type) for boolean variable is not economic, but highly efficient. 


In C/C++ environment, 0 is for false and any non-zero value is for true. For example: 


if (1234) 

printf ("this will always be executed Mn"); 
else 

printf ("this will never\n"); 


This is popular way of enumerating characters in a C-string: 


char *inputz...; 


while(*input) // execute body if *input character is non-zero 


{ 


// do something with *input 


thttps://math. recipes 
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input++; 


3 


2.1.2 Nibble AKA nybble 
AKA half-byte, tetrade. Equals to 4 bits. 


All these terms are still in use today. 


Binary-coded decimal (BCD?) 
4-bit nibbles were used in 4-bit CPUs like legendary Intel 4004 (used in calculators). 


It's interesting to know that there was binary-coded decimal (BCD) way of represent- 
ing decimal digit using 4 bits. Decimal 0 is represented as 0b0000, decimal 9 as 
0b1001 and higher values are not used. Decimal 1234 is represented as 0x1234. Of 
course, this way is not economical. 


Nevertheless, it has one advantage: decimal to BCD-packed number conversion 
and back is extremely easy. BCD-numbers can be added, subtracted, etc., but an 
additional correction is needed. x86 CPUs has rare instructions for that: AAA/DAA 
(adjust after addition), AAS/DAS (adjust after subtraction), AAM (after multiplication), 
AAD (after division). 


The need for CPUs to support BCD numbers is a reason why half-carry flag (on 
8080/Z80) and auxiliary flag (AF on x86) are exist: this is carry-flag generated af- 
ter proceeding of lower 4 bits. The flag is then used for adjustment instructions. 


The fact of easy conversion had led to popularity of [Peter Abel, IBM PC assembly 
language and programming (1987)] book. But aside of this book, the author of these 
notes never seen BCD numbers in practice, except for magic numbers (5.6.1 on 
page 906), like when someone's birthday is encoded like 0x19791011—this is indeed 
packed BCD number. 


Surprisingly, the author found a use of BCD-encoded numbers in SAP software: https: 
/ / yurichev.com/blog/SAP/. Some numbers, including prices, are encoded in BCD 
form in database. Perhaps, they used it to make it compatible with some ancient 
software/hardware? 


BCD instructions in x86 were often used for other purposes, especially in undocu- 
mented ways, for example: 


cmp al,10 
sbb al,69h 
das 


This obscure code converts number in 0..15 range into ASCII character '0'..'9', 'A'..'F'. 


2Binary-Coded Decimal 
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Z80 


Z80 was clone of 8-bit Intel 8080 CPU, and because of space constraints, it has 4-bit 
ALU, i.e., each operation over two 8-bit numbers had to be proceeded in two steps. 
One side-effect of this was easy and natural generation of half-carry flag. 


2.1.3 Byte 


Byte is primarily used for character storage. 8-bit bytes were not common as today. 
Punched tapes for teletypes had 5 and 6 possible holes, this is 5 or 6 bits for byte. 


To emphasize the fact the byte has 8 bits, byte is sometimes called octet: at least 
fetchmail uses this terminology. 


9-bit bytes used to exist in 36-bit architectures: 4 9-bit bytes would fit in a single 
word. Probably because of this fact, C/C++ standard tells that char has to have a 
room for at least 8 bits, but more bits are allowable. 


For example, in the early C language manual’, we can find this: 


char one byte character (PDP-11, IBM360: 8 bits; H6070: 9 bits) 


By H6070 they probably meant Honeywell 6070, with 36-bit words. 


Standard ASCII table 


7-bit ASCII table is standard, which has only 128 possible characters. Early E-Mail 
transport software were operating only on 7-bit ASCII codes, so a MIME^ standard 
needed to encode messages in non-Latin writing systems. 7-bit ASCII code was 
augmented by parity bit, resulting in 8 bits. 


Data Encryption Standard (DES?) has a 56 bits key, this is 8 7-bit bytes, leaving a 
space to parity bit for each character. 


There is no need to memorize whole ASCII table, but rather ranges. [0..0x1F] are 
control characters (non-printable). [0x20..0x7E] are printable ones. Codes starting 
at 0x80 are usually used for non-Latin writing systems and/or pseudographics. 


Significant codes which will be easily memorized are: O (end of C-string, 'X0' in 
C/C++); OxA or 10 (line feed, 'Nn' in C/C++); OxD or 13 (carriage return, 'Nr' in 
C/C++). 


0x20 (space) is also often memorized. 


8-bit CPUs 


x86 has capability to work with byte(s) on register level (because they are descen- 
dants of 8-bit 8080 CPU), RISC CPUs like ARM and MIPS—not. 


3https://yurichev.com/mirrors/C/bwk-tutor.html 
^Multipurpose Internet Mail Extensions 
3Data Encryption Standard 
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2.1.4 Wide char 


This is an attempt to support multi-lingual environment by extending byte to 16-bit. 
Most well-known example is Windows NT kernel and win32 functions with W suffix. 
This is why each Latin character in plain English text string is interleaved with zero 
byte. This encoding is called UCS-2 or UTF-16 


Usually, wchar t is synonym to 16-bit short data type. 


2.1.5 Signed integer vs unsigned 


Some may argue, why unsigned data types exist at first place, since any unsigned 
number can be represented as signed. Yes, but absence of sign bit in a value ex- 
tends its range twice. Hence, signed byte has range of -128..127, and unsigned 
one: 0..255. Another benefit of using unsigned data types is self-documenting: you 
define a variable which can't be assigned to negative values. 


Unsigned data types are absent in Java, for which it's criticized. It's hard to imple- 
ment cryptographical algorithms using boolean operations over signed data types. 


Values like OxFFFFFFFF (-1) are used often, mostly as error codes. 


2.1.6 Word 


Word word is somewhat ambiguous term and usually denotes a data type fitting 
in GPR. Bytes are practical for characters, but impractical for other arithmetical 
calculations. 


Hence, many CPUs have GPRs with width of 16, 32 or 64 bits. Even 8-bit CPUs 
like 8080 and Z80 offer to work with 8-bit register pairs, each pair forming a 16-bit 
pseudoregister (BC, DE, HL, etc.). Z80 has some capability to work with register 
pairs, and this is, in a sense, some kind of 16-bit CPU emulation. 


In general, if a CPU marketed as "n-bit CPU", this usually means it has n-bit GPRs. 


There was a time when hard disks and RAM modules were marketed as having n 
kilo-words instead of b kilobytes/megabytes. 


For example, Apollo Guidance Computer has 2048 words of RAM. This was a 16-bit 
computer, so there was 4096 bytes of RAM. 


TX-0 had 64K of 18-bit words of magnetic core memory, i.e., 64 kilo-words. 


DECSYSTEM-2060 could have up to 4096 kilowords of solid state memory (i.e., hard 
disks, tapes, etc). This was 36-bit computer, so this is 18432 kilobytes or 18 
megabytes. 


Essentially, why do you need bytes if you have words? Mostly for text strings pro- 
cessing. Words can be used in almost any other situations. 


int in C/C++ is almost always mapped to word. (Except of AMD64 architecture where 
int is still 32-bit one, perhaps, for the reason of better portability.) 
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int is 16-bit on PDP-11 and old MS-DOS compilers. int is 32-bit on VAX, on x86 starting 
at 80386, etc. 


Even more than that, if type declaration for a variable is omitted in C/C++ program, 

int is used silently by default. Perhaps, this is inheritance of B programming lan- 
6 

guage’. 


GPR is usually fastest container for variable, faster than packed bit, and sometimes 
even faster than byte (because there is no need to isolate a single bit/byte from 
GPR). Even if you use it as a container for loop counter in 0..99 range. 


Word in assembly language is still 16-bit for x86, because it was so for 16-bit 8086. 
Double word is 32-bit, quad word is 64-bit. That’s why 16-bit words are declared 
using DW in x86 assembly, 32-bit ones using DD and 64-bit ones using DQ. 


Word is 32-bit for ARM, MIPS, etc., 16-bit data types are called half-word there. 
Hence, double word on 32-bit RISC is 64-bit data type. 


GDB has the following terminology: halfword for 16-bit, word for 32-bit and giant 
word for 64-bit. 


16-bit C/C++ environment on PDP-11 and MS-DOS has /ong data type with width of 
32 bits, perhaps, they meant /ong word or long int? 


32-bit C/C++ environment has /ong long data type with width of 64 bits. 
Now you see why the word word is ambiguous. 


Should I use int? 


Some people argue that int shouldn't be used at all, because it ambiguity can lead 
to bugs. For example, well-known /zhuf library uses int at one point and everything 
works fine on 16-bit architecture. But if ported to architecture with 32-bit int, it can 
crash: http://yurichev.com/blog/lzhuf/. 


Less ambiguous types are defined in stdint.h file: uint8 t, uint16 t, uint32 t, uint64 t, 
etc. 


Some people like Donald E. Knuth proposed/ more sonorous words for these types: 
byte/wyde/tetrabyte/octabyte. But these names are less popular than clear terms 
with inclusion of u (unsigned) character and number right into the type name. 


Word-oriented computers 


Despite the ambiguity of the word term, modern computers are still word-oriented: 
RAM and all levels of cache are still organized by words, not by bytes. However, size 
in bytes is used in marketing. 


Shttp://yurichev.com/blog/typeless/ 
7http://www- cs- faculty.stanford.edu/~uno/news98. html 
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Access to RAM/cache by address aligned by word boundary is often cheaper than 
non-aligned. 


During data structures development, which are supposed to be fast and efficient, one 
should always take into consideration length of the word on the CPU to be executed 
on. Sometimes the compiler will do this for programmer, sometimes not. 


2.1.7 Address register 


For those who fostered on 32-bit and/or 64-bit x86, and/or RISC of 90s like ARM, 
MIPS, PowerPC, it's natural that address bus has the same width as GPR or word. 
Nevertheless, width of address bus can be different on other architectures. 


8-bit Z80 can address 2!6 bytes, using 8-bit registers pairs or dedicated registers (IX, 
IY). SP and PC registers are also 16-bit ones. 


Cray-1 supercomputer has 64-bit GPRs, but 24-bit address registers, so it can ad- 
dress 274 (16 megawords or 128 megabytes). RAM was very expensive in 1970s, 
and a typical Cray had 1048576 (0x100000) words of RAM or 8MB. So why to allo- 
cate 64-bit register for address or pointer? 


8086/8088 CPUs had a really weird addressing scheme: values of two 16-bit registers 
were summed in a weird manner resulting in a 20-bit address. Perhaps, this was 
some kind of toy-level virtualization (11.7 on page 1264)? 8086 could run several 
programs (not simultaneously, though). 


Early ARM1 has an interesting artifact: 


Another interesting thing about the register file is the PC register is 
missing a few bits. Since the ARM1 uses 26-bit addresses, the top 6 bits 
are not used. Because all instructions are aligned on a 32-bit boundary, 
the bottom two address bits in the PC are always zero. These 8 bits 
are not only unused, they are omitted from the chip entirely. 


(http://www. righto.com/2015/12/reverse-engineering-arml-ancestor-of.html 


) 


Hence, it’s physically not possible to push a value with one of two last bits set into 
PC register. Nor it’s possible to set any bits in high 6 bits of PC. 


x86-64 architecture has virtual 64-bit pointers/addresses, but internally, width of 
address bus is 48 bits (seems enough to address 256TB of RAM). 


2.1.8 Numbers 


What are numbers used for? 


When you see some number(s) altering in a CPU register, you may be interested in 
what this number means. It's an important skill for a reverse engineer to determine 
possible data type from a set of changing numbers. 
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Boolean 


If the number is switching from O to 1 and back, most chances that this value has 
boolean data type. 


Loop counter, array index 


Variable increasing from O, like: O, 1, 2, 3...—a good chance this is a loop counter 
and/or array index. 


Signed numbers 


If you see a variable which holds very low numbers and sometimes very high num- 
bers, like O, 1, 2, 3, and OxFFFFFFFF, OxFFFFFFFE, OxFFFFFFFD, there's a good chance 
it is a signed variable in two's complement form, and last 3 numbers are -1, -2, -3. 


32-bit numbers 


There are numbers so large, that there is even a special notation which exists to 
represent them (Knuth's up-arrow notation). These numbers are so large so these 
are not practical for engineering, science and mathematics. 


Almost all engineers and scientists are happy with IEEE 754 double precision floating 
point, which has maximal value around 1.8- 108°8. (As a comparison, the number of 
atoms in the observable universe, is estimated to be between 4-10” and 4. 10?!.) 


In fact, upper bound in practical computing is much, much lower. In MS-DOS era 
16-bit int was used almost for everything (array indices, loop counters), while 32-bit 
long was used rarely. 


During advent of x86-64, it was decided for int to stay as 32 bit size integer, because, 
probably, usage of 64-bit int is even rarer. 


| would say, 16-bit numbers in range 0..65535 are probably most used numbers in 
computing. 


Given that, if you see unusually large 32-bit value like 0x87654321, this is a good 
chance this can be: 


this can still be a 16-bit number, but signed, between OxFFFF8000 (-32768) and 
OxFFFFFFFF (-1). 


address of memory cell (can be checked using memory map feature of debug- 
ger). 


packed bytes (can be checked visually). 
bit flags. 


something related to (amateur) cryptography. 


magic number (5.6.1 on page 906). 


IEEE 754 floating point number (can also be checked). 


Almost same story for 64-bit values. 
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-SO 16-bit int is enough for almost everything? 


It's interesting to note: in [Michael Abrash, Graphics Programming Black Book, 1997 
chapter 13] we can find that there are plenty cases in which 16-bit variables are 
just enough. In a meantime, Michael Abrash has a pity that 80386 and 80486 CPUs 
has so little available registers, so he offers to put two 16-bit values into one 32-bit 
register and then to rotate it using ROR reg, 16 (on 80386 and later) (ROL reg, 16 
will also work) or BSWAP (on 80486 and later) instruction. 


That reminds us Z80 with alternate pack of registers (suffixed with apostrophe), to 
which CPU can switch (and then switch back) using EXX instruction. 


Size of buffer 


When a programmer needs to declare the size of some buffer, values in form of 2* 
are usually used (512 bytes, 1024, etc.). Values in 2* form are easily recognizable 
(1.28.5 on page 403) in decimal, hexadecimal and binary base. 


But needless to say, programmers are still humans with their decimal culture. And 
somehow, in DBMS area, size of textual database fields is often chosen as 10* num- 
ber, like 100, 200. They just think "Okay, 100 is enough, wait, 200 will be better". 
And they are right, of course. 


Maximum width of VARCHAR2 data type in Oracle RDBMS is 4000 characters, not 
4096. 


There is nothing wrong with this, this is just a place where numbers like 10” can be 
encountered. 


Address 


It's always a good idea to keep in mind an approximate memory map of the process 
you currently debug. For example, many win32 executables started at 0x00401000, 
So an address like 0x00451230 is probably located inside executable section. You'll 
see addresses like these in the EIP register. 


Stack is usually located somewhere below. 


Many debuggers are able to show the memory map of the debuggee, for example: 
1.12.3 on page 103. 


If a value is increasing by step 4 on 32-bit architecture or by step 8 on 64-bit one, 
this probably sliding address of some elements of array. 


It’s important to know that win32 doesn't use addresses below 0x10000, so if you 
see some number below this constant, this cannot be an address (see also: https: 
//msdn.microsoft.com/en-us/library/ms810627.aspx). 


Anyway, many debuggers can show you if the value in a register can be an address 
to something. OllyDbg can also show an ASCII string if the value is an address of it. 
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Bit field 

If you see a value where one (or more) bit(s) are flipping from time to time like 
0xABCD1234 > 0xABCD1434 and back, this is probably a bit field (or bitmap). 
Packed bytes 


When strcmp() or memcmp() copies a buffer, it loads/stores 4 (or 8) bytes simulta- 
neously, so if a string containing "4321", and it would be copied to another place, at 
one point you'll see 0x31323334 value in some register. This is 4 packed bytes into 
a 32-bit value. 


2.1.9 AND/OR/XOR as MOV 


OR reg, OxFFFFFFFF sets all bits to 1, hence, no matter what has been in register 
before, it will be set to -1. OR reg, -1is shorter than MOV reg, -1, so MSVC uses 
OR instead the latter, for example: 3.18.1 on page 661. 


Likewise, AND reg, 0 always resets all bits, hence, it acts like MOV reg, 0. 


XOR reg, reg, no matter what has been in register beforehand, resets all bits, and 
also acts like MOV reg, 0. 


2.2 Endianness 
The endianness is a way of representing values in memory. 


2.2.1 Big-endian 


The 0x12345678 value is represented in memory as: 


address in memory | byte value 
+0 0x12 
+1 0x34 
+2 0x56 
+3 0x78 


Big-endian CPUs include Motorola 68k, IBM POWER. 


2.2.2 Little-endian 


The 0x12345678 value is represented in memory as: 


address in memory | byte value 
+0 0x78 
+1 0x56 
+2 0x34 
+3 0x12 
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Little-endian CPUs include Intel x86. One important example of little-endian using 
in this book is: 1.35 on page 510. 


2.2.3 Example 
Let's take big-endian MIPS Linux installed and ready in QEMU 8. 


And let's compile this simple example: 


#include <stdio.h> 


int main() 
{ 
int v; 
v=123; 
printf ("%02X %02X %02X %02X\n", 
*(char*)&v, 
*(((char*)&v)+1), 
*(((char*)&v)+2), 
*(((char*)&v)43)); 
ur 


After running it we get: 


root@debian-mips:~# ./a.out 
00 00 00 7B 


That is it. Ox7B is 123 in decimal. In little-endian architectures, 7B is the first byte 
(you can check on x86 or x86-64), but here it is the last one, because the highest 
byte goes first. 


That’s why there are separate Linux distributions for MIPS (“mips” (big-endian) and 
“mipsel” (little-endian)). It is impossible for a binary compiled for one endianness to 
work on an OS with different endianness. 


There is another example of MIPS big-endiannes in this book: 1.30.4 on page 459. 


2.2.4 Bi-endian 


CPUs that may switch between endianness are ARM, PowerPC, SPARC, MIPS, 1A64?, 
etc. 


2.2.5 Converting data 


The BSWAP instruction can be used for conversion. 


8 available for download here: https://people.debian.org/~aurel32/qemu/mips/ 
?Intel Architecture 64 (Itanium) 
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TCP/IP network data packets use the big-endian conventions, so that is why a pro- 
gram working on a little-endian architecture has to convert the values. The htonl() 
and htons() functions are usually used. 


In TCP/IP, big-endian is also called "network byte order", while byte order on the com- 
puter "host byte order". "host byte order" is little-endian on Intel x86 and other little- 
endian architectures, but it is big-endian on IBM POWER, so htonl() and htons() 
don't shuffle any bytes on the latter. 


2.3 Memory 


There are 3 main types of memory: 


* Global memory AKA "static memory allocation". No need to allocate explicitly, 
the allocation is performed just by declaring variables/arrays globally. These 
are global variables, residing in the data or constant segments. They are avail- 
able globally (hence, considered as an anti-pattern). Not convenient for buffer- 
s/arrays, because they must have a fixed size. Buffer overflows that occur here 
usually overwrite variables or buffers residing next to them in memory. There's 
an example in this book: 1.12.3 on page 100. 


Stack AKA "allocate on stack". The allocation is performed just by declaring 
variables/arrays locally in the function. These are usually local variables for 
the function. Sometimes these local variable are also available to descending 
functions (to callee functions, if caller passes a pointer to a variable to the callee 
to be executed). Allocation and deallocation are very fast, it just SP needs to 
be shifted. 


But they're also not convenient for buffers/arrays, because the buffer size has 
to be fixed, unless alloca() (1.9.2 on page 47) (or a variable-length array) is 
used. Buffer overflows usually overwrite important stack structures: 1.26.2 on 
page 340. 


Heap AKA "dynamic memory allocation". Allocation/deallocation is performed 
by calling 

malloc()/free() or new/delete in C++. This is the most convenient method: 
the block size may be set at runtime. 


Resizing is possible (using realloc()), but can be slow. This is the slowest way 
to allocate memory: the memory allocator must support and update all control 
structures while allocating and deallocating. Buffer overflows usually overwrite 
these structures. Heap allocations are also source of memory leak problems: 
each memory block has to be deallocated explicitly, but one may forget about 
it, or do it incorrectly. 


Another problem is the "use after free"—using a memory block after free() 
has been called on it, which is very dangerous. 


Example in this book: 1.30.2 on page 435. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


575 


2.4 CPU 


2.4.1 Branch predictors 


Some latest compilers try to get rid of conditional jump instructions. Examples in 
this book are: 1.18.1 on page 170, 1.18.3 on page 180, 1.28.5 on page 413. 


This is because the branch predictor is not always perfect, so the compilers try to do 
without conditional jumps, if possible. 


Conditional instructions in ARM (like ADRcc) are one way, another one is the CMOVcc 
x86 instruction. 


2.4.2 Data dependencies 


Modern CPUs are able to execute instructions simultaneously (OOE?°), but in order 
to do so, the results of one instruction in a group must not influence the execution 
of others. Hence, the compiler endeavors to use instructions with minimal influence 
on the CPU state. 


That's why the LEA instruction is so popular, because it does not modify CPU flags, 
while other arithmetic instructions does. 


2.5 Hash functions 


A very simple example is CRC32, an algorithm that provides "stronger" checksum 
for integrity checking purposes. It is impossible to restore the original text from the 
hash value, it has much less information: But CRC32 is not cryptographically secure: 
it is known how to alter a text in a way that the resulting CRC32 hash value will be 
the one we need. Cryptographic hash functions are protected from this. 


MD5, SHA1, etc. are such functions and they are widely used to hash user pass- 
words in order to store them in a database. Indeed: an Internet forum database may 
not contain user passwords (a stolen database can compromise all users' passwords) 
but only hashes (so a cracker can't reveal the passwords). Besides, an Internet fo- 
rum engine does not need to know your password exactly, it needs only to check if 
its hash is the same as the one in the database, and give you access if they match. 
One of the simplest password cracking methods is just to try hashing all possible 
passwords in order to see which matches the resulting value that we need. Other 
methods are much more complex. 


2.5.1 How do one-way functions work? 


A one-way function is a function which is able to transform one value into another, 
while it is impossible (or very hard) to reverse it. Some people have difficulties while 
understanding how this is possible at all. Here is a simple demonstration. 


We have a vector of 10 numbers in range 0..9, each is present only once, for example: 


100ut.of-Order Execution 
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4601357892 


The algorithm for the simplest possible one-way function is: 
* take the number at zeroth position (4 in our case); 
* take the number at first position (6 in our case); 
* Swap numbers at positions of 4 and 6. 


Let's mark the numbers at positions 4 and 6: 


4601357892 


Let's swap them and we get this result: 


4601753892 


While looking at the result, and even if we know the algorithm, we can't know unam- 
biguously the initial state, because the first two numbers could be 0 and/or 1, and 
then they could participate in the swapping procedure. 


This is an utterly simplified example for demonstration. Real one-way functions are 
much more complex. 
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Chapter 3 


Slightly more advanced 
examples 


3.1 Zero register 


x86 architecture lacks zero register, unlike MIPS and ARM. However, it's often a case, 
when a compiler assigns a zero to a register, that will hold it upon the function's exit. 


This is a case of Mahjong game from Windows 7 x86. Zeroed EBX (at 0x010281BF) 
is used to initialize local variables, to pass zero argument into other functions and 


to compare values against it. 


Listing 3.1: Mahjong.exe from Windows 7 x86 


.text 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
:010281AE 


.text 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


:010281AE 


010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 
010281AE 


010281AE 
010281AE 
010281B0 
010281B5 
010281BA 
010281BC 


sub_10281AE 


var_34 
var_30 
var 2C 
var 28 
var 24 
var 20 
var 1C 
var 18 
var 14 
var 10 
var 4 
arg 0 
arg 4 


proc near ; CODE XREF: sub 1028790+4FFp 


dword 
dword 
dword 
dword 
dword 
dword 
dword 
dword 
dword 
dword 
dword 
dword 


; sub 102909A+357p ... 


ptr -34h 
ptr -30h 
ptr -2Ch 
ptr -28h 
ptr -24h 
ptr -20h 
ptr -1Ch 
ptr -18h 
ptr -14h 
ptr -10h 
ptr -4 

ptr 8 


byte ptr 0Ch 


28h 

eax, offset — ehhandler ... 
. EH prolog3 

edi, ecx 

esi, [ebp«arg 0] 
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.text:010281BF xor ebx, ebx pt 
.text:010281C1 mov [ebp+var_10], ebx p% 
.text:010281C4 cmp [esi], ebx ; * 
. text: 010281C6 jbe short loc_10281E8 

. text: 010281C8 

.text:010281C8 loc 10281C8: ; CODE XREF: sub 10281AE+38j 
.text:010281C8 mov eax, [esi+0Ch] 
.text:010281CB mov ecx, [ebp+var_10] 
.text:010281CE push dword ptr [eax+ecx*4] 
.text:010281D1 call sub 10506C9 

.text:010281D6 mov eax, [ebp+var_10] 

. text: 010281D9 pop ecx 

.text:010281DA mov ecx, [esi+0Ch] 
.text:010281DD mov [ecx+eax*4], ebx E 
.text:010281E0 inc eax 

.text:010281E1 mov [ebp-var 10], eax 
.text:010281E4 cmp eax, [esi] 

.text:010281E6 jb short loc 10281C8 
.text:010281E8 

.text:010281bE8 loc 10281E8: ; CODE XREF: sub 10281AE+18j 
.text:010281E8 mov [esi], ebx - 
.text:010281EA mov [edi+14h], ebx E 
.text:010281ED mov [ebp+var_34], ebx A 
.text:010281F0 mov [ebp-var 30], ebx de 
.text:010281F3 mov [ebp-var 2C], 10h 
.text:010281FA mov [ebp-var 28], ebx dao 
.text:010281FD mov [ebp-var 4], ebx ES 
.text:01028200 mov [ebp+arg 0], ebx E 
.text:01028203 cmp [edi-0BOh], ebx vk 
.text:01028209 jbe loc 10282C3 

.text:0102820F 

.text:0102820F loc 102820F: ; CODE XREF: sub 10281AE+10Fj 
.text:0102820F mov eax, [edi+0BCh] 
.text:01028215 mov ecx, [ebp«arg 0] 
.text:01028218 mov eax, [eax+ecx*4] 
.text:0102821B mov [ebp-var 14], eax 
.text:0102821E cmp eax, ebx POT 
.text:01028220 jz loc 10282A6 

.text:01028226 push ebx im 
.text:01028227 push eax 

.text:01028228 mov ecx, edi 

.text:0102822A call sub 1026B3D 

.text:0102822F test al, al 

.text:01028231 jz short loc 10282A6 
.text:01028233 mov [ebp-var 24], ebx $7 
.text:01028236 mov [ebp-var 20], ebx E 
.text:01028239 mov [ebp-var 1C], 10h 
.text:01028240 mov [ebp-var 18], ebx "E 
.text:01028243 lea eax, [ebp«var 34] 

. text: 01028246 push eax 

. text: 01028247 lea eax, [lebp+var_24] 

. text: 0102824A push eax 

. text: 0102824B push [ebp+var_14] 
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text:0102824E mov ecx, edi 

text:01028250 mov byte ptr [ebp+var 4], 1 
text:01028254 call sub 1026E4F 

text:01028259 mov [ebp-var 10], ebx > CE 
text:0102825C cmp [ebp+var_24], ebx ak 
text: 0102825F jbe short loc_102829B 
text:01028261 

text:01028261 loc 1028261: ; CODE XREF: sub 10281AE+EBj 
text:01028261 push OCh; Size 

text:01028263 call sub 102bE741 

text:01028268 pop ecx 

text:01028269 cmp eax, ebx EG 
text:0102826B jz short loc 1028286 
text:0102826D mov edx, [ebp+var_10] 

text:01028270 mov ecx, [ebp+var_18] 

text:01028273 mov ecx, [ecx+edx*4] 

text:01028276 mov edx, [ebp+var_ 14] 

text:01028279 mov edx, [edx«4] 

text:0102827C mov [eax], edx 

text:0102827E mov [eax+4], ecx 

text:01028281 mov [eax+8], ebx NES 
text:01028284 jmp short loc 1028288 
text:01028286 ; 

text:01028286 

text:01028286 loc 1028286: ; CODE XREF: sub 10281AE+BDj 
text:01028286 xor eax, eax 

text:01028288 

text:01028288 loc 1028288: ; CODE XREF: sub 10281AE+D6j 
text:01028288 push eax 

text:01028289 mov ecx, esi 

text:0102828B call sub 104922B 

text:01028290 inc [ebp+var_10] 

text: 01028293 mov eax, [ebp+var_10] 

text: 01028296 cmp eax, [ebp+var 24] 

text :01028299 jb short loc 1028261 
text:0102829B 

text:0102829B loc 102829B: ; CODE XREF: sub 10281AE-*B1j 
text:0102829B lea ecx, [ebp+var_24] 

text:0102829E mov byte ptr [ebp+var_ 4], bl 
text:010282A1 call sub 10349DB 

text:010282A6 

text:010282A6 loc 10282A6: ; CODE XREF: sub 10281AE+72j 
text:010282A6 ; Sub 10281AE+83j 
text:010282A6 push [ebp+arg_ 0] 

text:010282A9 lea ecx, [ebp+var_34] 

text:010282AC call sub 104922B 

text:010282B1 inc [ebp+arg_ 0] 

text: 010282B4 mov eax, [ebp«arg 0] 

text:010282B7 cmp eax, [edi-0B0h] 

text:010282BD jb loc 102820F 

text:010282C3 

text:010282C3 loc 10282C3: ; CODE XREF: sub 10281AE+5Bj 
text:010282C3 cmp [ebp+arg 4], bl 
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text:010282C6 jz short loc 1028337 

text:010282C8 mov eax, dword 1088AD8 

text:010282CD mov esi, ds:EnableMenuItem 
text:010282D3 mov edi, 40002 

text:010282D8 cmp [eax+8], ebx NES 

text:010282DB jnz short loc 10282bC 

text:010282DD push 3 ; uEnable 

text:010282DF push edi ; ulIDEnableItem 
text:010282E0 push hMenu ; hMenu 

text:010282E6 call esi ; EnableMenultem 

text:010282E8 push 3 

text:010282EA jmp short loc 10282F7 

text:010282EC ; 

text:010282bC 

text:010282bC loc 10282EC: ; CODE XREF: sub 10281AE+12Dj 
text:010282bC push ebx ER 

text:010282ED push edi ; uIDEnableItem 
text:010282EE push hMenu ; hMenu 

text:010282F4 call esi ; EnableMenuItem 

text:010282F6 push ebx sk 

text:010282F7 

text:010282F7 loc 10282F7: ; CODE XREF: sub 10281AE-*13Cj 
text:010282F7 push edi ; ulIDEnableItem 
text:010282F8 push hmenu ; hMenu 

text:010282FE call esi ; EnableMenuItem 

text:01028300 mov ecx, dword 1088AD8 

text:01028306 call sub 1020402 

text:0102830B mov edi, 40001 

text:01028310 test al, al 

text:01028312 jz short loc 1028321 

text:01028314 push ebx Ro 

text:01028315 push edi ; ulIDEnableItem 
text:01028316 push hMenu ; hMenu 

text:0102831C call esi ; EnableMenuItem 

text:0102831E push ebx DON 

text:0102831F jmp short loc 102832E 

text:01028321 ; 

text:01028321 

text:01028321 loc 1028321: ; CODE XREF: sub 10281AE-*164j 
text:01028321 push 3 ; uEnable 

text:01028323 push edi ; ulIDEnableItem 
text:01028324 push hMenu ; hMenu 

text:0102832A call esi ; EnableMenuItem 

text:0102832C push 3 ; uEnable 

text:0102832E 

text:0102832E loc_102832E: ; CODE XREF: sub_10281AE+171j 
text:0102832E push edi ; UIDEnableltem 
text:0102832F push hmenu ; hMenu 

text:01028335 call esi ; EnableMenuItem 

text:01028337 

text:01028337 loc 1028337: ; CODE XREF: sub 10281AE-*118j 
text:01028337 lea ecx, [ebpevar 34] 

text:0102833A call sub 10349DB 
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.text:0102833F call . EH epilog3 
.text:01028344 retn 8 
.text:01028344 sub 10281AE endp 


By the way, IDA can rename a register inside a function (press n): 


Listing 3.2: Mahjong.exe from Windows 7 x86 


.text:010281AE sub 10281AE proc near 


.text:010281AE zero = ebx 


.text:010281BF xor zero, zero "d 
.text:010281C1 mov [ebp-var 10], zero "o 
.text:010281C4 cmp [esi], zero ES 
.text:010281C6 jbe short loc 10281E8 


3.2 Double negation 


A popular way! to convert non-zero value into 1 (or boolean true) and zero value into 
0 (or boolean false) is !!statement: 


int convert to bool(int a) 


1 
i 


return !!a; 


Optimizing GCC 5.4 x86: 


convert_to bool: 


mov edx, DWORD PTR [esp+4] 
xor eax, eax 

test edx, edx 

setne al 

ret 


XOR always clears return value in EAX, even in case if SETNE will not trigger. l.e., XOR 
sets default return value to zero. 


If the input value is not equal to zero (-NE suffix in SET instruction), 1 is set to AL, 
otherwise AL isn't touched. 


Why SETNE operates on low 8-bit part of EAX register? Because the matter is just in 
the last bit (0 or 1), while other bits are cleared by XOR. 


1This way is also controversial, because it leads to hard-to-read code 
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Therefore, that C/C++ code could be rewritten like this: 


int convert to bool(int a) 


1 
if (a!=0) 
return 1; 
else 
return 0; 
y: 
...Or even: 
int convert_to_bool(int a) 
{ 
if (a) 
return 1; 
else 
return 0; 
F; 


Compilers targeting CPUs lacking instruction similar to SET, in this case, generates 
branching instructions, etc. 


3.3 const correctness 


This is undeservedly underused feature of many programming languages. Read here 
about its importance: 1, 2. 


Ideally, everything you don't modify should have const modifier. 


Interestingly, how const correctness is implemented at low level. There are no run- 
time checks of local const variables and function arguments (only compile-time 
checks). But global variables of such a type are to be allocated in read-only data 
segments. 


This is example is to be crashed, because if compiled by MSVC for win32, the a global 
variable is allocated in . rdata read-only segment: 


const a-123; 


void f(int *i) 


{ 
*i=11; // crash 
ur 
int main() 
f(&a); 
return a; 
ur 


Anonymous (not linked to a variable name) C strings also have const char* type. 
You can't modify them: 
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#include <string.h> 
#include <stdio.h> 


void alter_string(char *s) 


{ 
strcpy (s, "Goodbye!"); 
printf ("Result: %s\n", s); 
}; 
int main() 
{ 
alter string ("Hello, world!\n"); 
}; 


This code will crash on Linux (“segmentation fault”) and on Windows if compiled by 
MinGW. 


GCC for Linux places all text strings info . rodata data segment, which is explicitly 
read-only ("read only data"): 


$ objdump -s 1 


Contents of section .rodata: 
400600 01000200 52657375 6c743a20 25730a00 ....Result: %s.. 
400610 48656c6c 6f2c2077 6f726c64 210a00 Hello, world!.. 


When the alter string() function tries to write there, exception occurred. 


Things are different in the code generated by MSVC, strings are located in .data 
segment, which has no READONLY flag. MSVC's developers misstep? 


C:\...>objdump -s 1.exe 


Contents of section .data: 

40b000 476f6f64 62796521 00000000 52657375 Goodbye!....Resu 
40b010 6c743a20 25730a00 48656c6c 6f2c2077 lt: %s..Hello, w 
40b020 6f726c64 210a0000 00000000 00000000 orld!........... 
40b030 01000000 00000000 cOcb4000 00000000 .......... Q..... 


C:\...>objdump -x 1.exe 


Sections: 
Idx Name Size VMA LMA File off Algn 
0 .text 00006d2a 00401000 00401000 200000400 2**2 


CONTENTS, ALLOC, LOAD, READONLY, CODE 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


584 


1 .rdata 00002262 00408000 00408000 200007200 2**2 
CONTENTS, ALLOC, LOAD, READONLY, DATA 

2 .data 00000e00 2O0040b000 0040b000 200009600 2**2 
CONTENTS, ALLOC, LOAD, DATA 

3 .reloc 00000b98 20040e000 20040e000 20000a400 2**2 


CONTENTS, ALLOC, LOAD, READONLY, DATA 


However, MinGW hasn't this fault and allocates text strings in . rdata segment. 


3.3.1 Overlapping const strings 


The fact that an anonymous C-string has const type (1.5.1 on page 12), and that 
C-strings allocated in constants segment are guaranteed to be immutable, has an 
interesting consequence: the compiler may use a specific part of the string. 


Let's try this example: 


#include <stdio.h> 


int f1() 
{ 
printf ("world\n"); 
} 
int f2() 
1 
printf ("hello world\n"); 
} 
int main() 
{ 
f1(); 
f2(); 
} 


Common C/C++-compilers (including MSVC) allocate two strings, but let's see what 
GCC 4.8.1 does: 


Listing 3.3: GCC 4.8.1 + IDA listing 


f1 proc near 
S = dword ptr -1Ch 
sub esp, 1Ch 
mov [esp+1Ch+s], offset s ; "worldXn" 
call | puts 
add esp, 1Ch 
retn 
fl endp 
f2 proc near 
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S = dword ptr -1Ch 
sub esp, 1Ch 
mov [esp+1Ch+s], offset aHello ; "hello " 
call | puts 
add esp, 1Ch 
retn 
f2 endp 
aHello db 'hello ' 
S db 'world',0xa,0 


Indeed: when we print the "hello world" string these two words are positioned in 
memory adjacently and puts() called from f2() function is not aware thatthis string 
is divided. In fact, it's not divided; it's divided only virtually, in this listing. 


When puts() is called from f1(), ituses the "world" string plus a zero byte. puts() 
is not aware that there is something before this string! 


This clever trick is often used by at least GCC and can save some memory. This is 
close to string interning. 


Another related example is here: 3.4. 


3.4 strstr() example 


Let's back to the fact that GCC sometimes can use part of string: 3.3.1 on the previ- 
ous page. 


The strstr() C/C++ standard library function is used to find any occurrence in a string. 
This is what we will do: 


#include <string.h> 
#include <stdio.h> 


int main() 

{ 
char *s="Hello, world!"; 
char *w=strstr(s, "world"); 


printf ("%p, [%s]\n", s, s) 
printf ("%p, [%s]\n", w, w) 


, 
, 


i 


The output is: 


0x8048530, [Hello, world! ] 
0x8048537, [world!] 


The difference between the address of the original string and the address of the 
substring that strstr() has returned is 7. Indeed, "Hello, " string has length of 7 
characters. 
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The printf() function during second call has no idea there are some other char- 
acters before the passed string and it prints characters from the middle of original 
string till the end (marked by zero byte). 


3.5 qsort() revisited 


(Let's back to the fact that CMP instruction works like SUB: 1.12.4 on page 113.) 


Now that you already familiar with qsort() function (1.33 on page 483), here is a nice 
example where comparison operation (CMP) can be replaced by subtraction operation 
(SUB). 


/* qsort int comparison function */ 
int int cmp(const void *a, const void *b) 


const int *ia (const int *)a; // casting pointer types 
const int *ib (const int *)b; 
return *ia - *ib; 

/* integer comparison: returns negative if b > a 

and positive if a » b */ 


} 


(http://www.anyexample.com/programming/c/qsort sorting array of strings 
integers and structs.xml http://archive.is/Hh3jz ) 


Also, a typical implementation of strcmp() (from OpenBSD): 


int 
strcmp(const char *s1, const char *s2) 
1 

while (*s1 == *s2++) 

if (*sl44 == 0) 
return (0); 

return (*(unsigned char *)s1 - *(unsigned char *)--s2); 

} 


3.6 Temperature converting 


Another very popular example in programming books for beginners is a small pro- 
gram that converts Fahrenheit temperature to Celsius or back. 


5- (F -32) 
9 


C= 


We can also add simple error handling: 1) we must check if the user has entered 
a correct number; 2) we must check if the Celsius temperature is not below -273 
(which is below absolute zero, as we may recall from school physics lessons). 


The exit() function terminates the program instantly, without returning to the caller 
function. 
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3.6.1 


Integer values 


#include <stdio.h> 
#include <stdlib.h> 


int main() 


{ 


F 


int celsius, fahr; 

printf ("Enter temperature in Fahrenheit:\n"); 

if (scanf ("%d", &fahr)!=1) 

{ 
printf ("Error while parsing your input\n"); 
exit(0); 

}; 


celsius = 5 * (fahr-32) / 9; 


if (celsius<-273) 

{ 
printf ("Error: incorrect temperature!\n"); 
exit(0); 

} 


printf ("Celsius: %d\n", celsius); 


Optimizing MSVC 2012 x86 


Listing 3.4: Optimizing MSVC 2012 x86 


$SG4228 DB ‘Enter temperature in Fahrenheit:', 0aH, 00H 
$5G4230 DB '%d', OOH 
$5G4231 DB ‘Error while parsing your input', 0aH, 00H 
$SG4233 DB ‘Error: incorrect temperature!', 0aH, 00H 
$5G4234 DB ‘Celsius: %d', OaH, OOH 
 fahr$ = -4 ; size = 4 
_main PROC 
push ecx 
push esi 
mov esi, DWORD PTR imp printf 
push OFFSET $5G4228 ; 'Enter temperature in Fahrenheit:' 
call esi ; call printf() 
lea eax, DWORD PTR _fahr$[esp+12] 
push eax 
push OFFSET $SG4230 ; '%d' 
call DWORD PTR imp scanf 
add esp, 12 
cmp eax, 1 
je SHORT $LN2@main 
push OFFSET $SG4231 ; ‘Error while parsing your input' 
call esi ; call printf () 
add esp, 4 
push 0 
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call DWORD PTR imp exit 


$LN9@main: 
$LN2@main: 
mov eax, DWORD PTR _fahr$[esp+8] 
add eax, -32 ; ffffffeoH 
lea ecx, DWORD PTR [eax+eax*4] 
mov eax, 954437177 ; 38e38e39H 
imul ecx 
sar edx, 1 
mov eax, edx 
shr eax, 31 ; 0000001fH 
add eax, edx 
cmp eax, -273 ; fffffeefH 
jge SHORT $LN1@main 
push OFFSET $5G4233 ; 'Error: incorrect temperature! ' 
call esi ; call printf() 
add esp, 4 
push 0 
call DWORD PTR imp exit 
$LN10@main: 
$LN1@main: 
push eax 
push OFFSET $SG4234 ; 'Celsius: %d' 
call esi ; call printf() 
add esp, 8 
; return 0 - by C99 standard 
xor eax, eax 
pop esi 
pop ecx 
ret 0 
$LN8@main: 
main  ENDP 


What we can say about it: 


The address of printf() is first loaded in the ESI register, so the subsequent 
printf() calls are done just by the CALL ESI instruction. It's a very popular 
compiler technique, possible if several consequent calls to the same function 
are present in the code, and/or if there is a free register which can be used for 
this. 


We see the ADD EAX, -32instruction at the place where 32 has to be subtracted 
from the value. EAX = EAX + (-32) is equivalent to EAX = EAX - 32 and 
somehow, the compiler decided to use ADD instead of SUB. Maybe it’s worth it, 
it’s hard to be sure. 


The LEA instruction is used when the value is to be multiplied by 5: lea ecx, 
DWORD PTR [eax+eax*4]. Yes, ¿+1+ 4 is equivalent to ¿+5 and LEA works faster 
then IMUL. 

By the way, the SHL EAX, 2 / ADD EAX, EAX instruction pair could be also 
used here instead— some compilers do it like. 


The division by multiplication trick (3.12 on page 621) is also used here. 
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* main() returns O if we don't have return 0 at its end. The C99 standard tells 

us [ISO/IEC 9899:TC3 (C C99 standard), (2007)5.1.2.2.3] that main() will return 

0 in case the return statement is missing. This rule works only for the main() 
function. 


Though, MSVC doesn't officially support C99, but maybe it support it partially? 


Optimizing MSVC 2012 x64 


The code is almost the same, but we can find INT 3 instructions after each exit() 
call. 


xor ecx, ecx 
call QWORD PTR imp exit 
int 3 


INT 3 is a debugger breakpoint. 


It is known that exit() is one of the functions which can never return 2, so if it does, 
something really odd has happened and it’s time to load the debugger. 


3.6.2 Floating-point values 


#include <stdio.h> 
#include <stdlib.h> 


int main() 
{ 
double celsius, fahr; 
printf ("Enter temperature in Fahrenheit:\n"); 
if (scanf ("%lf", &fahr) !=1) 
{ 
printf ("Error while parsing your input\n"); 
exit(0); 
}; 


celsius = 5 * (fahr-32) / 9; 


if (celsius<-273) 
1 
printf ("Error: incorrect temperature!\n"); 
exit(0); 
}; 
printf ("Celsius: %lf\n", celsius); 
}; 


MSVC 2010 x86 uses FPU instructions... 
Listing 3.5: Optimizing MSVC 2010 x86 


| $5G4038 DB ‘Enter temperature in Fahrenheit:', 0aH, 00H 


2another popular one is longjmp() 
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$5G4040 DB '%lf', OOH 


$SG4041 DB ‘Error while parsing your input', 0aH, 00H 
$5G4043 DB ‘Error: incorrect temperature!', 0aH, 00H 
$SG4044 DB ‘Celsius: %lf', OaH, 00H 
__real@c071100000000000 DQ 0c071100000000000r ; -273 
__real@4022000000000000 DQ 04022000000000000r ; 9 
__real@4014000000000000 DQ 04014000000000000r ; 5 
__real@4040000000000000 DQ 04040000000000000r + 32 
 fahr$ = -8 ; size = 8 
main PROC 

sub esp, 8 

push esi 

mov esi, DWORD PTR imp printf 

push OFFSET $5G4038 ; 'Enter temperature in Fahrenheit:' 

call esi ; Call printf() 

lea eax, DWORD PTR _fahr$[esp+16] 

push eax 

push OFFSET $SG4040 > '%lf' 

call DWORD PTR imp scanf 

add esp, 12 

cmp eax, 1 

je SHORT $LN2@main 

push OFFSET $SG4041 ; ‘Error while parsing your input’ 

call esi ; call printf () 

add esp, 4 

push 0 

call DWORD PTR imp exit 
$LN2@main: 

fld QWORD PTR _fahr$[esp+12] 

fsub QWORD PTR __real@4040000000000000 ; 32 

fmul QWORD PTR  realQ4014000000000000 ; 5 

fdiv QWORD PTR  realQ4022000000000000 ; 9 

fld QWORD PTR __real@c071100000000000 ; -273 

fcomp ST(1) 

fnstsw ax 

test ah, 65 ; 00000041H 

jne SHORT $LN1@main 

push OFFSET $564043 ; ‘Error: incorrect temperature! ' 

fstp ST(0) 

call esi ; call printf() 

add esp, 4 

push 0 

call DWORD PTR imp exit 
$LN1@main: 

sub esp, 8 

fstp QWORD PTR [esp] 

push OFFSET $SG4044 ; ‘Celsius: %lf' 

call esi 

add esp, 12 


; return O - by C99 standard 


xor 


eax, eax 
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pop esi 
add esp, 8 
ret 0 
$LN10@main: 
main  ENDP 


...Dut MSVC 2012 uses SIMD instructions instead: 
Listing 3.6: Optimizing MSVC 2010 x86 


$SG4228 DB ‘Enter temperature in Fahrenheit:', 0aH, 00H 
$5G4230 DB '%lf', 00H 
$5G4231 DB ‘Error while parsing your input', 0aH, 00H 
$SG4233 DB ‘Error: incorrect temperature!', 0aH, 00H 
$SG4234 DB ‘Celsius: %lf', OaH, 00H 
__real@c071100000000000 DQ 0c071100000000000r ; -273 
__real@4040000000000000 DQ 04040000000000000r 2-32 
. realg4022000000000000 DQ 04022000000000000r ;9 
. reale4014000000000000 DQ 04014000000000000r : 5 
_fahr$ = -8 ; size = 8 
main PROC 
sub esp, 8 
push esi 
mov esi, DWORD PTR imp printf 
push OFFSET $5G4228 ; 'Enter temperature in Fahrenheit:' 
call esi ; Call printf() 
lea eax, DWORD PTR _fahr$[esp+16] 
push eax 
push OFFSET $SG4230 > '%lf' 
call DWORD PTR imp scanf 
add esp, 12 
cmp eax, 1 
je SHORT $LN2@main 
push OFFSET $SG4231 ; ‘Error while parsing your input’ 
call esi ; call printf () 
add esp, 4 
push 0 
call DWORD PTR imp exit 
$LN9@main: 
$LN2@main: 


movsd xmm1, QWORD PTR _fahr$[esp+12] 
subsd xmm1, QWORD PTR __real@4040000000000000 ; 32 


movsd xmm0, QWORD PTR _ real@c071100000000000 ; -273 
mulsd xmm1, QWORD PTR __real@4014000000000000 ; 5 
divsd xmm1, QWORD PTR __real@4022000000000000 ; 9 
comisd xmm0, xmml 
jbe SHORT $LN1@main 
push OFFSET $5G4233 ; 'Error: incorrect temperature! ' 
call esi ; call printf() 
add esp, 4 
push 0 
call DWORD PTR imp exit 

$LN10@main: 
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$LN1@main: 
sub esp, 8 
movsd QWORD PTR [esp], xmml 
push OFFSET $564234 ; 'Celsius: %lf' 
call esi ; call printf() 
add esp, 12 
; return 0 - by C99 standard 
xor eax, eax 
pop esi 
add esp, 8 
ret 0 
$LN8@main: 
main  ENDP 


Of course, SIMD instructions are available in x86 mode, including those working with 
floating point numbers. 


It’s somewhat easier to use them for calculations, so the new Microsoft compiler 
uses them. 


We can also see that the -273 value is loaded into XMMO register too early. And that's 
OK, because the compiler may emit instructions not in the order they are in the 
source code. 


3.7 Fibonacci numbers 


Another widespread example used in programming textbooks is a recursive function 
that generates the Fibonacci numbers?. The sequence is very simple: each consec- 
utive number is the sum of the previous two. The first two numbers are 0 and 1, or 
l and 1. 


The sequence starts like this: 
0,1, 1,2,3,5,8, 13, 21, 34, 55, 89, 144, 233, 377, 610, 987, 1597, 2584, 4181... 


3.7.1 Example #1 


The implementation is simple. This program generates the sequence until 21. 


#include <stdio.h> 


void fib (int a, int b, int limit) 


{ 
printf ("%d\n", a+b); 
if (a+b > limit) 
return; 
fib (b, a+b, limit); 
$; 
int main() 


3http://oeis.org/A000045 
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1 
printf ("0nlAnlAn"); 
fib (1, 1, 20); 
}; 
Listing 3.7: MSVC 2010 x86 
a$=8 ; size = 4 
_b$ = 12 ; size = 4 
_limit$ = 16 ; size = 4 
fib PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
add eax, DWORD PTR _b$[ebp] 
push eax 
push OFFSET $SG2643 
call DWORD PTR _imp_ printf 
add esp, 8 
mov ecx, DWORD PTR a$[ebp] 
add ecx, DWORD PTR _b$[ebp] 
cmp ecx, DWORD PTR _limit$[ebp] 
jle SHORT $LN1@fib 
jmp SHORT $LN2@fib 
$LN1@fib: 
mov edx, DWORD PTR _limit$[ebp] 
push edx 
mov eax, DWORD PTR a$[ebp] 
add eax, DWORD PTR _b$[ebp] 
push eax 
mov ecx, DWORD PTR _b$[ebp] 
push ecx 
call fib 
add esp, 12 
$LN2Gfib: 
pop ebp 
ret 0 
fib ENDP 
_Main PROC 
push ebp 
mov ebp, esp 
push OFFSET $5G2647 ; "O\nl1\n1\n" 
call DWORD PTR imp printf 
add esp, 4 
push 20 
push 1 
push 1 
call fib 
add esp, 12 
xor eax, eax 
pop ebp 
ret 0 
main  ENDP 
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We will illustrate the stack frames with this. 
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Let's load the example in OllyDbg and trace to the last call of f(): 


CPU - main thread, module fib 
aarDiaaoao 


HOU EBP, ESP 2 

MOU EAX, DWORD PTR SS:IEBP481 ieee 
ADD EAX, DWORD PTR SS: CEBP+C] Aoa ESEE 
PUSH EAX EN 
PUSH f ib. BØFD3000 ODISF94D 
CALL DWORD PTR DS: [<2MSUCRIGB.printf>1 i Bede. 


HOU ECK! DWORD PTR SS:CEBP+8) DON 

ADD ECX, DWORD PTR SS: CEBP+C] GOFDSS76 fib. CBF 09978 

CMP ECX DWORD PTR SS: LEBP+19] @@FD163D f ib. G9F0103D 
ib. ØØFD10 ES 0028 32bit @(FFFFFFFF) 

JMP SHORT fib.GOBFD103C CS 0023 32bit B(FFFFFFFF) 

Be riae c9 [eur Epis SS 092B 32bit G(FFFFFFFF) 

DS 0028 32bit G(FFFFFFFF) 
MOU EAX, DWORD PTR SS: CEBP+8] 
ADD EAX, DWORD PTR SS: EBP4CI AS esate EIN Mao la 


prese UE LastErr ERROR SUCCESS (09949098) 
CALL f ib. @aFD1000 90909202 (NO,NB,NE,A,NS, PO, GE, G) 
ADD ESP, OC 


goFDiasc|| 5 SD P” 
OOF D1030 LPE 


Address | Hes dump — 1 [ascir | 


BOFD3ODB 


RETURN fib.D9FD1039 f ib. 0ØFD1000 


RETURN fib.D9FD1039 from fib.00FD1000 


RETURN f ib. 0ØFD1039 f ib. 0ØFD1000 


RETURN fib. 0ØFD1039 from fib.090FD1000 


RETURN f ib. 0ØFD105C f ib. 0ØFD1000 


RETURN fib.@6FD11D8 from fib.00FD1040 


Pointer to nest SEH record 
SE handler 


74C1338A| RETURN to kernel32.74C1338R 


Figure 3.1: OllyDbg: last call of f() 
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Let's investigate the stack more closely. Comments were added by the author of 
this book ^: 


0035F940  00FD1039 RETURN to fib.00FD1039 from fib.00FD1000 
0035F944 00000008 Ist argument: a 

0035F948  0000000D 2nd argument b 

0035F94C 00000014 3rd argument: limit 

0035F950 /0035F964 saved EBP register 

0035F954 |00FD1039 RETURN to fib.00FD1039 from fib.00FD1000 
0035F958 |00000005 1st argument: a 

0035F95C |00000008 2nd argument: b 

0035F960 |00000014 3rd argument: limit 

0035F964 ]0035F978 saved EBP register 

0035F968 |00FD1039 RETURN to fib.00FD1039 from fib.00FD1000 
0035F96C |00000003 lst argument: a 

0035F970 |00000005 2nd argument: b 

0035F974 |00000014 3rd argument: limit 

0035F978 ]0035F98C saved EBP register 

0035F97C  |00FD1039 RETURN to fib.00FD1039 from fib.00FD1000 
0035F980 |00000002 lst argument: a 

0035F984 |00000003 2nd argument: b 

0035F988 |00000014 3rd argument: limit 

0035F98C ]0035F9AQ saved EBP register 

0035F990 |00FD1039 RETURN to fib.00FD1039 from fib.00FD1000 
0035F994 |00000001 1st argument: a 

0035F998 |00000002 2nd argument: b 

0035F99C |00000014 3rd argument: limit 

0035F9A0 ]0035F9B4 saved EBP register 

0035F9A4 |Q0FD105C RETURN to fib.00FD105C from fib.00FD1000 
0035F9A8 |00000001 ist argument: a \ 

0035F9AC |00000001 2nd argument: b | prepared in main() for f1() 
0035F9BO |00000014 3rd argument: limit / 

0035F9B4 ]0035F9F8 saved EBP register 

0035F9B8 |00FD11DO RETURN to fib.Q0FD11D0 from fib.00FD1040 
0035F9BC |00000001 main() 1st argument: argc \ 

0035F9CO |006812C8 main() 2nd argument: argv | prepared in CRT for main() 
0035F9C4 |00682940 main() 3rd argument: envp / 


The function is recursive ?, hence stack looks like a "sandwich". 


We see that the limit argument is always the same (0x14 or 20), but the a and b 
arguments are different for each call. 


There are also the RA-s and the saved EBP values. OllyDbg is able to determine the 
EBP-based frames, so it draws these brackets. The values inside each bracket make 
the stack frame, in other words, the stack area which each function incarnation uses 
as scratch space. 


We can also say that each function incarnation must not access stack elements be- 
yond the boundaries of its frame (excluding function arguments), although it's tech- 
nically possible. 


^By the way, it's possible to select several entries in OllyDbg and copy them to the clipboard (Ctrl-C). 
That's what was done by author for this example. 
5i.e., it calls itself 
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It's usually true, unless the function has bugs. 


Each saved EBP value is the address of the previous stack frame: this is the reason 
why some debuggers can easily divide the stack in frames and dump each function's 
arguments. 


As we see here, each function incarnation prepares the arguments for the next func- 
tion call. 


At the end we see the 3 arguments for main(). argc is 1 (yes, indeed, we have ran 
the program without command-line arguments). 


This easily to lead to a stack overflow: just remove (or comment out) the limit check 
and it will crash with exception 0xC00000FD (stack overflow.) 


3.7.2 Example #2 


My function has some redundancy, so let’s add a new local variable next and replace 
all “a+b” with it: 


#include <stdio.h> 


void fib (int a, int b, int limit) 


{ 
int next=a+b; 
printf ("%d\n", next); 
if (next > limit) 
return; 
fib (b, next, limit); 
yi 
int main() 
{ 
printf ("0nlAnlAn"); 
fib (1, 1, 20); 
F 


This is the output of non-optimizing MSVC, so the next variable is actually allocated 
in the local stack: 


Listing 3.8: MSVC 2010 x86 


_next$ = -4 ; size = 4 

_ag = 8 ; size = 4 

_b$ = 12 ; size = 4 

_limit$ = 16 ; size = 4 

_ fib PROC 
push ebp 
mov ebp, esp 
push ecx 
mov eax, DWORD PTR _a$[ebp] 
add eax, DWORD PTR _b$[ebp] 
mov DWORD PTR _next$[ebp], eax 
mov ecx, DWORD PTR _next$[ebp] 
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$LN1@fib: 
mov 
push 
mov 
push 
mov 
push 
call 
add 

$LN2Gfib: 
mov 
pop 
ret 

fib ENDP 


main PROC 
push 
mov 
push 
call 
add 
push 
push 
push 
call 
add 
xor 
pop 
ret 

main  ENDP 


ecx 
OFFSET $SG2751 ; ‘%d' 

DWORD PTR imp printf 
esp, 8 

edx, DWORD PTR next$[ebp] 
edx, DWORD PTR  limit$[ebp] 
SHORT $LN1@fib 

SHORT $LN2@fib 


eax, DWORD PTR  limit$[ebp] 
eax 

ecx, DWORD PTR next$[ebp] 
ecx 

edx, DWORD PTR _b$[ebp] 

edx 


ebp 

ebp, esp 

OFFSET $5G2753 ; "“O\n1\n1\n" 
DWORD PTR imp printf 

esp, 4 
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Let's load it in OllyDbg once again: 


52 
ES C6FFFFFF 
8304 aC 


Moo... ee 


ODEB103F 


A 


GGEG1041 
BaEBia42 


Return to BBEBIBSR (fib2.88EG103R) 


aaEasaaa 


POP EBP 
RETN 


ADD EAX, DWORD PTR SS: [EBP+C] 
MOV DWORD PTR SS: [EBP-4],EAX 
MOV ECX, DWORD PTR SS: [EBP-4] 
PUSH ECX 

PUSH f ib2. 69E93008 

CALL DWORD PTR DS: (<&MSUCR16G. printf >] 
ADD ESP,3 

MOU EDX,DWORD PTR SS: CEBP-4] 
CMP EDX, DWORD PTR SS: [EBP+10] 
JLE SHORT fib2.00E61029 

JMP SHORT fib2.00E6163D 

MOV EAX, DWORD PTR SS: CEBP+16] 
PUSH ERX 

MOV ECX, DWORD PTR SS: [EBP-4] 
PUSH ECX 

MOV EDX, DWORD PTR SS: CEBP+C] 
PUSH EDX 

CALL f ib2.00E01000 

ADD ESP, ØC 

MOU ESP,EBP 


INTS 
INTS 


aaaaaaan 
00000014 
aaaaaaan 
aa2srcaa 
aaEaiasn 
aaaaaaas 
aaaaaaas 
aaaanai4 
goggas 
aa2srcos 
DOEGIOSA 
goggas 
aaaaaaas 
00000014 
aaaaaaas 
aa2src?a 
aakatasn 
aaaaaaa2 
aaaaaaa3 
00000014 
aaaaaaas 
aa2srces 


00000014 
goggggøz 
aa29rcoc 


m 


00000014 
aa2srcEa 
GGEG11EG 
aaaaaaoat 
aaasi2cs 
aaas2940 
BFF371AC 
aaaaaaaa 


gogogo 
TEFDEGBaaG 
aaaaaaaa 
aaaaaaaa 
aa2srcba 
E9996B77 
BOB29FD1C 


BO29FCDO 


CEE] 
6Fa8S617 
90900015 
aaaaaaaa 
BB29FC14 
BB29FC28 
96060681 
00E03378 


00E01040 


empty 
empty 
empty 
empty 
empty 
empty 


RETURN 


RETURN 


RETURN 


RETURN 


RETURN 


RETURN 


f ib2. Ø0EØ1Ø3A from 


fib2.00E0103A from 


fib2.00E6103A from 


fib2.80EB183R from 


fib2.00EG106C from 


f ib2. 00E011E0 from 


MSUCR100. 6F085617 


f ib2. 00E03378 
f ib2. 00E01040 


22bit G(FFFFFFFF) 
22bit O(FFFFFFFF) 
32bit G(FFFFFFFF) 
32bit ØLFFFFFFFF) 
32bit 7EFODGGG( FFF) 
S2bit O(FFFFFFFF) 


ERROR SUCCESS (66868006) 
(NO, NB, NE, A, NS, PO, GE, G) 


fib2.00E0100€ 


fib2.00E0100€ 


fib2.00E0100t 


fib2.00E0100€ 


fib2.00E0100€ 


fib2.00E0105t 


Pointer to next SEH record 


Figure 3.2: OllyDbg: last call of f() 


Now the next variable is present in each frame. 
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Let's investigate the stack more closely. The author has again added his comments: 


0029FC14 
0029FC18 
0029FC1C 
0029FC20 
0029FC24 
0029FC28 
0029FC2C 
0029FC30 
0029FC34 
0029FC38 
0029FC3C 
0029FC40 
0029FC44 
0029FC48 
0029FC4C 
0029FC50 
0029FC54 
0029FC58 
0029FC5C 
0029FC60 
0029FC64 
0029FC68 
0029FC6C 
0029FC70 
0029FC74 
0029FC78 
0029FC7C 


y call 


0029FC80 
0029FC84 
0029FC88 
0029FC8C 
0029FC90 
0029FC94 
0029FC98 
0029FC9C 
0029FCAO 
0029FCA4 
0029FCA8 
0029FCAC 


00E0103A 
00000008 
0000000D 
00000014 
0000000D 
/0029FC40 
| 00E0103A 
| 00000005 
| 00000008 
| 00000014 
| 00000008 
10029FC58 
| 00E0103A 
| 00000003 
| 00000005 
| 00000014 
| 00000005 
10029FC70 
| 00E0103A 
| 00000002 
| 00000003 
| 00000014 
| 00000003 
10029FC88 
| 00E0103A 
[00000001 
| 00000002 


[00000014 
| 00000002 
10029FC9C 
| 00E0106C 
[00000001 
[00000001 
[00000014 
10029FCEO 
| 00E011E0 
[00000001 
|000812C8 
| 00082940 


RETURN to fib2.00E0103A from fib2. 
lst argument: a 

2nd argument: b 

3rd argument: limit 

"next" variable 

saved EBP register 

RETURN to fib2.00E0103A from fib2. 
lst argument: a 

2nd argument: b 

3rd argument: limit 

"next" variable 

saved EBP register 

RETURN to fib2.00E0103A from fib2. 
lst argument: a 

2nd argument: b 

3rd argument: limit 

"next" variable 

saved EBP register 

RETURN to fib2.00E0103A from fib2. 
lst argument: a 

2nd argument: b 

3rd argument: limit 

"next" variable 

saved EBP register 

RETURN to fib2.00E0103A from fib2. 
1st argument: a \ 

2nd argument: b | prepared in 


3rd argument: limit / 

"next" variable 

saved EBP register 

RETURN to fib2.00E0106C from fib2. 
1st argument: a \ 

2nd argument: b | prepared in 
3rd argument: limit / 

saved EBP register 

RETURN to fib2.00E011E0 from fib2. 
main() 1st argument: argc \ 


00E01000 


00E01000 


00E01000 


00E01000 


00E01000 


f1() for next f1() 


00E01000 


main() for f1() 


00E01050 


4 


main() 2nd argument: argv | prepared in CRT for main() 


main() 3rd argument: envp / 


Here we see it: the next value is calculated in each function incarnation, then passed 
as argument b to the next incarnation. 


3.7.3 Summary 


Recursive functions are aesthetically nice, but technically may degrade performance 
because of their heavy stack usage. Everyone who writes performance critical code 
probably should avoid recursion. 


For example, the author of this book once wrote a function to seek a particular node 
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in a binary tree. As a recursive function it looked quite stylish but since additional 
time was spent at each function call for the prologue/epilogue, it was working a 
couple of times slower than an iterative (recursion-free) implementation. 


By the way, that is the reason that some functional PL? compilers (where recursion 
is used heavily) use tail call. We talk about tail call when a function has only one 
single call to itself located at the end of it, like: 


Listing 3.9: Scheme, example is copypasted from Wikipedia 


;; factorial : number -> number 
;; to calculate the product of all positive 
;; integers less than or equal to n. 
(define (factorial n) 
(if (=n 1) 
1 
(* n (factorial (- n 1))))) 


Tail call is important because compiler can rework this code easily into iterative one, 
to get rid of recursion. 


3.8 CRC32 calculation example 


This is a very popular table-based CRC32 hash calculation technique/. 


/* By Bob Jenkins, (c) 2006, Public Domain */ 
<stdio.h> 
<stddef.h> 


<string.h> 


#include 
#include 
#include 


ub4; 
ubl; 


typedef 
typedef 


unsigned long 
unsigned char 


static const ub4 crctab[256] = 4 


0x00000000, 
0x706af48f, 
Oxe0d5e9le, 
O0x90bf1d91, 
0x1adad47d, 
0x646ba8c0, 
Oxfa0f3d63, 
0xa2677172, 
0x35b5a8fa, 
0x45df5c75, 
0xc8d75180, 
Oxb8bda50f, 
0x2f6f7c87, 
0x01db7106, 
Ox9fbfe4a5, 


0x77073096, 
0xe963a535, 
0x97d2d988, 
0x1db71064, 
Ox6ddde4eb, 
Oxfd62f97a, 
0x8d080df5, 
0x3c03e4d1, 
0x42b2986c, 
Oxdcd60dcf, 
Oxbfd06116, 
0x2802b89e, 
0x58684c11, 
0x98d220bc, 
0xe8b8d433, 


0xee0e612c, 
0x9e6495a3, 
0x09b64c2b, 
0x6ab020f2, 
Oxf4d4b551, 
0x8a65c9ec, 
0x3b6e20c8, 
0x4b04d447, 
Oxdbbbc9d6, 
Oxabd13d59, 
0x21b4f4b5, 
0x5f058808, 
0xc1611dab, 
Oxefd5102a, 
0x7807c9a2, 


0x990951ba, 
0x0edb8832, 
Ox7eb17cbd, 
0xf3b97148, 
0x83d385c7, 
0x14015c4f, 
0x4c69105e, 
Oxd20d85fd, 
Oxacbcf940, 
0x26d930ac, 
0x56b3c423, 
0xc60cd9b2, 
0xb6662d3d, 
0x71b18589, 
0x0f00f934, 


0x076dc419, 
0x79dcb8a4, 
0xe7b82d07, 
0x84be41de, 
0x136c9856, 
0x63066cd9, 
0xd56041e4, 
0xa50ab56b, 
0x32d86ce3, 
0x51de003a, 
Oxcfba9599, 
0xb10be924, 
0x76dc4190, 
0x06b6b51f, 
0x9609a88e, 


$LISP, Python, Lua, etc. 
7The source code has been taken from here: http: //burtleburtle.net/bob/c/crc.c 
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0xe10e9818, 
0x6b6b51f4, 
0x1b01a57b, 
Ox8bbeb8ea, 
Oxfbd44c65, 
Ox4adfa541, 
0x346ed9fc, 
0xaa0a4c5f, 
0xc90c2086, 
Ox5edef90e, 
0x2eb40d81, 
0x03b6e20c, 
0x73dc1683, 
Oxe40ecfOb, 
0x8708a3d2, 
0x196c3671, 
0x67dd4acc, 
Oxd6d6a3e8, 
0xa6bc5767, 
0x36034af6, 
0x4669be79, 
0xcc0c7795, 
0xb2bd0b28, 
0x2cd99e8b, 
0x026d930a, 
0x95bf4a82, 
Oxe5d5be0d, 
0x68ddb3f8, 
0x18b74777, 
0x8f659eff, 
0xd70dd2ee, 
0x4969474d, 
0x37d83bf0, 
Oxbdbdf21c, 
0xcdd70693, 
0x5d681b02, 
0x2d02ef8d 
ur 


/* how to derive the values in crctab[] from polynomial 0xedb88320 */ 


0x7f6aO0dbb, 
0x1c6c6162, 
0x8208f4c1, 
Oxfcb9887c, 
0x4db26158, 
0x3dd895d7, 
0xad678846, 
0xdd0d7cc9, 
0x5768b525, 
0x29d9c998, 
Oxb7bd5c3b, 
0x74b1d29a, 
0xe3630b12, 
0x9309f f9d, 
0x1e01f268, 
0x6e6b06e7, 
Oxf9b9df6f, 
0xa1d1937e, 
0x3fb506dd, 
0x41047a60, 
Oxcb61b38c, 
0xbb0b4703, 
0x2bb45a92, 
Ox5bdeaeld, 
0x9c0906a9, 
0xe2b87a14, 
0x7cdcefb7, 
Ox1fda836e, 
0x88085ae6, 
Oxf862ae69, 
0x4e048354, 
0x3e6e77db, 
O0xa9bcae53, 
Oxcabac28a, 
0x54de5729, 
0x2a6f2b94, 


void build table() 


1 
ub4 i, j; 
for 

E i 


Wow gu gm Hn Hn m H I — 


1=0; 1<256; ++1) 4 


((j&1) 
((j&1) 
((j&1) 
((j&1) 
((j&1) 
((j&1) 
((j&1) 
((j&1) 


> > > > > > > > 


NYNNNNN NS 


0x086d3d2d, 
0x856530d8, 
Oxf50fc457, 
0x62dd1ddf, 
0x3ab551ce, 
0xa4d1c46d, 
Oxda60b8d0, 
0x5005713c, 
0x206f85b3, 
0xb0d09822, 
OxcOba6cad, 
0xead54739, 
0x94643b84, 
0x0a00ae27, 
0x6906c2fe, 
Oxfed41b76, 
Ox8ebeeff9, 
0x38d8c2c4, 
0x48b2364b, 
Oxdf60efc3, 
O0xbc66831a, 
0x220216b9, 
0x5cb36a04, 
0x9b64c2b0, 
0xeb0e363f, 
0x7bb12bae, 
OxObdbdf21, 
Ox8lbel6cd, 
Oxff0Of6a70, 
0x616bf fd3, 
0x3903b3c2, 
Oxaedl6ala, 
Oxdebb9ec5, 
0x53b39330, 
0x23d967bf, 
0xb40bbe37, 


Oxedb88320 : 
0xedb88320 : 
0xedb88320 : 
0xedb88320 : 
Oxedb88320 : 
Oxedb88320 : 
Oxedb88320 : 
0xedb88320 : 


0x91646c97, 
0xf262004e, 
0x65b0d9c6, 
0x15da2d49, 
0xa3bc0074, 
Oxd3d6f4fb, 
0x44042d73, 
0x270241aa, 
0xb966d409, 
0xc7d7a8b4, 
Oxedb88320, 
0x9dd277af, 
0x0d6d6a3e, 
0x7d079eb1, 
0xf762575d, 
0x89d32be0, 
0x17b7be43, 
Ox4fdff252, 
0xd80d2bda, 
0xa867df55, 
0x256fd2a0, 
0x5505262f, 
Oxc2d7ffa7, 
0xec63f226, 
0x72076785, 
0x0cb61b38, 
0x86d3d2d4, 
Oxf6b9265b, 
0x66063bca, 
0x166ccf45, 
0xa7672661, 
0xd9d65adc, 
0x47b2cf7f, 
0x24b4a3a6, 
0xb3667a2e, 
0xc30c8ea1, 


QOoooqooo0o0o0 


0xe6635c01, 
0x6c0695ed, 
0x12b7e950, 
0x8cd37cf3, 
0xd4bb30e2, 
0x4369e96a, 
0x33031de5, 
Oxbe0b1010, 
Oxce61e49Ff, 
0x59b33d17, 
Ox9abfb3b6, 
0x04db2615, 
0x7a6ab5aa8, 
0xf00f9344, 
0x806567cb, 
0x10da7ab5a, 
0x60b08ed5, 
Oxd1bb67f1, 
Oxaf0alb4c, 
0x316e8eef, 
0x5268e236, 
Oxc5ba3bbe, 
Oxb5d0cf31, 
0x756aa39c, 
0x05005713, 
0x92d28e9b, 
0xf1d4e242, 
0x6fb077e1, 
0x11010b5c, 
0xa00ae278, 
0xd06016f7, 
0x40df0b66, 
Ox30b5f fed, 
0xbad03605, 
0xc4614ab8, 
0x5a05dflb, 
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printf("0xs.8lx, ", j); 
if (i%6 == 5) printf("\n"); 
} 
} 


/* the hash function */ 
ub4 crc(const void *key, ub4 len, ub4 hash) 
1 
ub4 i; 
const ubl *k - key; 
for (hash=len, i20; i«len; ++i) 
hash = (hash >> 8) ^ crctab[(hash & Oxff) ^ k[ill; 
return hash; 


) 


/* To use, try "gcc -0 crc.c -o crc; cre < crc.c" */ 
int main() 


char s[1000]; 
while (gets(s)) printf("%.8lx\n", crc(s, strlen(s), 0)); 
return 0; 


} 


We are interested in the crc() function only. By the way, pay attention to the two 
loop initializers in the for() statement: hash=len, i=0. The C/C++ standard allows 
this, of course. The emitted code will contain two operations in the loop initialization 
part instead of one. 


Let's compile it in MSVC with optimization (/Ox). For the sake of brevity, only the 
crc() function is listed here, with my comments. 


_key$ = 8 ; size = 4 
_len$ = 12 ; size = 4 
_hash$ = 16 ; size = 4 
| crc PROC 
mov edx, DWORD PTR  len$[esp-4] 
xor ecx, ecx ; i will be stored in ECX 
mov eax, edx 
test edx, edx 
jbe SHORT $LN1@crc 
push ebx 
push esi 
mov esi, DWORD PTR _key$[esp+4] ; ESI = key 
push edi 
$LL3@crc: 


; work with bytes using only 32-bit registers. byte from address key+i we 
store into EDI 


movzx edi, BYTE PTR [ecx+esi] 
mov ebx, eax ; EBX = (hash = Len) 
and ebx, 255 ; EBX = hash & Oxff 
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; XOR EDI, EBX (EDI-EDI^EBX) 

; this operation uses all 32 bits of each register 

; but other bits (8-31) are cleared all time, so it is OK 

; these are cleared because, as for EDI, it was done by MOVZX instruction 


above 
; high bits of EBX was cleared by AND EBX, 255 instruction above (255 = Oxff) 
xor edi, ebx 


; EAX=EAX>>8; bits 24-31 taken from nowhere will be cleared 
shr eax, 8 


; EAX=EAX*crctab[EDI*4] - choose EDI-th element from crctab[] table 
xor eax, DWORD PTR crctab[edi*4] 


inc ecx ; i++ 
cmp ecx, edx ; i«len ? 
jb SHORT $LL3@crc ; yes 
pop edi 
pop esi 
pop ebx 
$LNlecre: 
ret 0 
| crc ENDP 


Let's try the same in GCC 4.4.1 with -03 option: 


public crc 
crc proc near 
key - dword ptr 8 
hash = dword ptr OCh 
push ebp 
xor edx, edx 
mov ebp, esp 
push esi 
mov esi, [ebp+key] 
push ebx 
mov ebx, [ebp+hash] 
test ebx, ebx 
mov eax, ebx 
jz short loc 80484D3 
nop ; padding 
lea esi, [esi+0] ; padding; works as NOP (ESI does not 
change here) 
loc 80484B8: 
mov ecx, eax ; save previous state of hash to ECX 
xor al, [esitedx]; AL=*(key+i) 
add edx, 1 ; itt 
shr ecx, 8 ; ECX=hash>>8 
movzx eax, al ; EAX=*(key+i) 
mov eax, dword ptr ds:crctab[eax*4] ; EAX=crctab[EAX] 
xor eax, ecx ; hash-EAX^ECX 
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cmp ebx, edx 

ja short loc 80484B8 
loc 80484D3: 

pop ebx 

pop esi 

pop ebp 

retn 
crc endp 


GCC has aligned the loop start on a 8-byte boundary by adding NOP and lea esi, 
[esi+0] (that is an idle operation too). Read more about it in npad section (.1.7 on 
page 1313). 


3.9 Network address calculation example 
As we know, a TCP/IP address (IPv4) consists of four numbers in the 0...255 range, 
i.e., four bytes. 


Four bytes can be fit in a 32-bit variable easily, so an IPv4 host address, network 
mask or network address can all be 32-bit integers. 


From the user's point of view, the network mask is defined as four numbers and is 
formatted like 255.255.255.0 or so, but network engineers (sysadmins) use a more 
compact notation (CIDR), like "/8", "/16", etc. 


This notation just defines the number of bits the mask has, starting at the MSB. 


Mask | Hosts Usable Netmask Hex mask 

/30 4 2 255.255.255.252 | Oxfffffffc 

/29 8 6 255.255.255.248 | Oxfffffff8 

/28 16 14 255.255.255.240 | OxfffffffO 

127 32 30 255.255.255.224 | OxffffffeO 

/26 64 62 255.255.255.192 | OxffffffcO 

124 256 254 255.255.255.0 OxffffffOO class C network 
/23 512 510 255.255.254.0 Oxfffffe00 

/22 1024 1022 255.255.252.0 OxfffffcOO 

/21 2048 2046 255.255.248.0 Oxfffff800 

/20 4096 4094 255.255.240.0 OxfffffOO0 

/19 8192 8190 255.255.224.0 Oxffffe000 

/18 16384 16382 255.255.192.0 OxffffcOO0 

/17 32768 32766 255.255.128.0 Oxffff8000 

/16 65536 65534 255.255.0.0 OxffffO000 class B network 
/8 16777216 | 16777214 | 255.0.0.0 Oxff000000 | class A network 


Here is a small example, which calculates the network address by applying the net- 
work mask to the host address. 


#include <stdio.h> 
#include <stdint.h> 


8Classless Inter-Domain Routing 
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uint32 t form IP (uint8 t ipl, uint8 t ip2, uint8 t ip3, uint8 t ip4) 


1 
return (ipl««24) | (ip2<<16) | (ip3««8) | ip4; 
y; 
void print as IP (uint32 t a) 
1 
printf ("%d.%d.%d.%d\n", 
(a>>24)60xFF, 
(a>>16)60xFF, 
(a>>8)60xFF, 
(a) &OxFF) ; 
$; 
// bit=31..0 


uint32 t set bit (uint32 t input, int bit) 
1 


Fi 


return input=input| (1<<bit) ; 


uint32 t form netmask (uint8 t netmask bits) 


1 
uint32 t netmask-0; 
uint8 t i; 


for (i20; i<netmask bits; i++) 
netmask=set_bit(netmask, 31-i); 


return netmask; 


yi 


void calc network address (uint8 t ipl, uint8 t ip2, uint8 t ip3, uint8 t 7 


S ip4, uint8 t netmask bits) 


1 
uint32 t netmask-form netmask(netmask bits); 
uint32 t ip-form IP(ipl, ip2, ip3, ip4); 
uint32 t netw adr; 
printf ("netmask=") ; 
print_as IP (netmask) ; 
netw_adr=ip&netmask; 
printf ("network address=") ; 
print_as IP (netw_adr); 

}; 

int main() 

{ 
calc_network_address (10, 1, 2, 4, 24); // 10. 
calc network address (10, 1, 2, 4, 8); // 10. 
calc network address (10, 1, 2, 4, 25); // 10. 
calc network address (10, 1, 2, 64, 26); // 10. 


/24 
/8 

/25 
/26 
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PE 


3.9.1 calc_network_address() 


calc network address() function is simplest one: it just ANDs the host address 


with the network mask, resulting in the network address. 


Listing 3.10: Optimizing MSVC 2012 /ObO 


_ipl$ = 8 ; size = 1 
_ip2$ = 12 ; size = 1 
_ip3$ = 16 ; size = 1 
_ip4$ = 20 ; size = 1 
_netmask_bits$ = 24 ; size = 1 
calc network address PROC 
push edi 
push DWORD PTR netmask bits$[esp] 
call form netmask 
push OFFSET $5G3045 ; 'netmask=' 
mov edi, eax 
call DWORD PTR imp printf 
push edi 
call print as IP 


push OFFSET $SG3046 ; ‘network address=' 
call DWORD PTR imp printf 
push DWORD PTR _ip4$[esp+16] 
push DWORD PTR _ip3$[esp+20] 


_calc_network_address ENDP 


push DWORD PTR _ip2$[esp+24] 

push DWORD PTR _ipl$[esp+28] 

call form IP 

and eax, edi ; network address - host address & netmask 
push eax 

call | print as IP 

add esp, 36 

pop edi 

ret 0 


At line 22 we see the most important AND—here the network address is calculated. 


3.9.2 form IP() 
The form IP() function just puts all 4 bytes into a 32-bit value. 
Here is how it is usually done: 


* Allocate a variable for the return value. Set it to O. 


* Take the fourth (lowest) byte, apply OR operation to this byte and return the 


value. The return value contain the 4th byte now. 


* Take the third byte, shift it left by 8 bits. You'll get a value like Ox0000bb00 
where bb is your third byte. Apply the OR operation to the resulting value and 
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returning value. The return value has contained 0x000000aa so far, so ORing 
the values will produce a value like 0x0000bbaa. 


* Take the second byte, shift it left by 16 bits. You'll get a value like 0x00cc0000, 
where cc is your second byte. Apply the OR operation to the resulting value and 
returning value. The return value has contained 0x0000bbaa so far, so ORing 
the values will produce a value like 0x00ccbbaa. 


Take the first byte, shift it left by 24 bits. You'll get a value like 0Oxdd000000, 
where dd is your first byte. Apply the OR operation to the resulting value and 
returning value. The return value has contained 0x00ccbbaa so far, so ORing 
the values will produce a value like Oxddccbbaa. 


And this is how it's done by non-optimizing MSVC 2012: 


Listing 3.11: Non-optimizing MSVC 2012 


; denote ipl as "dd", ip2 as "cc", ip3 as "bb", ip4 as "aa". 


_ipl$ = 8 ; size = 1 
_ip2$ = 12 ; size = 1 
_ip3$ = 16 ; size = 1 
_ip4$ = 20 ; size = 1 
form IP PROC 

push ebp 

mov ebp, esp 


movzx eax, BYTE PTR _ipl$[ebp] 
; EAX=000000dd 

shl eax, 24 

; EAX=dd000000 

movzx ecx, BYTE PTR _ip2$[ebp] 
; ECX=000000cc 


shl ecx, 16 
; ECX=00cc0000 
or eax, ecx 


; EAX=ddcc0000 
movzx edx, BYTE PTR _ip3$[ebp] 
; EDX=000000bb 


shl edx, 8 
; EDX=0000bb00 
or eax, edx 


; EAX=ddccbb00 
movzx ecx, BYTE PTR _ip4$[ebp] 
; ECX=000000aa 


or eax, ecx 
; EAX=ddccbbaa 
pop ebp 

ret 0 


_form_IP ENDP 


Well, the order is different, but, of course, the order of the operations doesn’t matter. 


Optimizing MSVC 2012 does essentially the same, but in a different way: 
Listing 3.12: Optimizing MSVC 2012 /ObO 
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; denote ipl as "dd", ip2 as "cc", ip3 as "bb", ip4 as "aa". 


_ipl$ = 8 ; size = 1 
_ip2$ = 12 ; size = 1 
_ip3$ = 16 ; size = 1 
_ip4$ = 20 ; size = 1 
form IP PROC 


movzx eax, BYTE PTR _ipl$[esp-4] 
; EAX-000000dd 
movzx ecx, BYTE PTR _ip2$[esp-4] 
; ECX=000000cc 


shl eax, 8 
; EAX=0000dd00 
or eax, ecx 


; EAX-0000ddcc 
movzx ecx, BYTE PTR ip3$[esp-4] 
; ECX-000000bb 


shl eax, 8 
; EAX=00ddcc00 
or eax, ecx 


; EAX=00ddccbb 
movzx ecx, BYTE PTR  ip4$[esp-4] 
; ECX=000000aa 
shl eax, 8 
; EAX=ddccbb00 
or eax, ecx 
; EAX=ddccbbaa 
ret 0 
form IP ENDP 


We could say that each byte is written to the lowest 8 bits of the return value, and 
then the return value is shifted left by one byte at each step. 


Repeat 4 times for each input byte. 
That's it! Unfortunately, there are probably no other ways to do it. 


There are no popular CPUs or ISAs which has instruction for composing a value from 
bits or bytes. 


It's all usually done by bit shifting and ORing. 


3.9.3 print as IP() 


print as IP() does the inverse: splitting a 32-bit value into 4 bytes. 


Slicing works somewhat simpler: just shift input value by 24, 16, 8 or O bits, take 
the bits from zeroth to seventh (lowest byte), and that's it: 


Listing 3.13: Non-optimizing MSVC 2012 


_ag = 8 ; size = 4 
print as IP PROC 

push ebp 

mov ebp, esp 

mov eax, DWORD PTR a$[ebp] 
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; EAX=ddccbbaa 


and eax, 255 

; EAX=000000aa 

push eax 

mov ecx, DWORD PTR _a$[ebp] 
; ECX=ddccbbaa 

shr ecx, 8 

; ECX=00ddccbb 

and ecx, 255 

; ECX=000000bb 

push ecx 

mov edx, DWORD PTR _a$[ebp] 
; EDX=ddccbbaa 

shr edx, 16 

; EDX=0000ddcc 

and edx, 255 

; EDX=000000cc 

push edx 

mov eax, DWORD PTR _a$[ebp] 
; EAX=ddccbbaa 

shr eax, 24 

; EAX=000000dd 

and eax, 255 ; probably redundant instruction 
; EAX=000000dd 

push eax 


push OFFSET $5G2973 ; ‘%d.%d.%d.%d' 
call DWORD PTR imp printf 


add esp, 20 
pop ebp 
ret 0 


print as IP ENDP 


Optimizing MSVC 2012 does almost the same, but without unnecessary reloading of 
the input value: 


Listing 3.14: Optimizing MSVC 2012 /ObO 


; size = 4 


print as IP PROC 


mov ecx, DWORD PTR a$[esp-4] 
; ECX=ddccbbaa 
movzx eax, cl 
; EAX=000000aa 


push eax 

mov eax, ecx 
; EAX=ddccbbaa 
shr eax, 8 

; EAX=00ddccbb 
and eax, 255 
; EAX=000000bb 
push eax 

mov eax, ecx 
; EAX=ddccbbaa 
shr eax, 16 
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; EAX=00 
and 

; EAX=00 
push 

; ECX«dd 
shr 

; ECX=00 
push 
push 
call 

add 

ret 


090ddcc 

eax, 255 

0000cc 

eax 

ccbbaa 

ecx, 24 

0000dd 

ecx 

OFFSET $SG3020 ; . %d .%d . %d ' 
DWORD PTR _imp_ printf 
esp, 20 

0 


'% 


_print_as_IP ENDP 


3.9.4 form_netmask() and set_bit() 


form netmask() 


makes a network mask value from CIDR notation. Of course, it 


would be much effective to use here some kind of a precalculated table, but we 
consider it in this way intentionally, to demonstrate bit shifts. 


We will also write 
a function for suc 
works. 


a separate function set bit(). It's a not very good idea to create 
h primitive operation, but it would be easy to understand how it all 


Listing 3.15: Optimizing MSVC 2012 /ObO 


_input$ = 8 
_bit$ = 12 
Set bit PROC 
mov 
mov 
shl 
or 
ret 
set bit ENDP 


 netmask bits$ - 


form netmask PROC 


push 
push 
movzx 
xor 
xor 
test 
jte 
xor 
$LL3@form_netma: 

mov 
sub 
push 
push 
call 
inc 


; size = 4 
; size = 4 
ecx, DWORD PTR _bit$[esp-4] 
eax, 1 
eax, cl 
eax, DWORD PTR _input$[esp-4] 
0 
8 ; Size- 1 
ebx 
esi 
esi, BYTE PTR netmask bits$[esp+4] 
ecx, ecx 
bl, bl 
esi, esi 
SHORT $LN9@form_netma 
edx, edx 
eax, 31 
eax, edx 
eax 
ecx 
set bit 
bl 
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movzx edx, bl 


add esp, 8 

mov ecx, eax 

cmp edx, esi 

jt SHORT $LL3@form_netma 
$LN9Gform netma: 

pop esi 

mov eax, ecx 

pop ebx 

ret 0 


form netmask ENDP 


set bit() is primitive: it just shift left 1 to number of bits we need and then ORs it 
with the "input" value. form netmask() has a loop: it will set as many bits (starting 
from the MSB) as passed in the netmask bits argument 


3.9.5 Summary 
That's it! We run it and getting: 


netmask=255.255.255.0 
network address=10.1.2.0 
netmask=255.0.0.0 

network address=10.0.0.0 
netmask=255.255.255.128 
network address=10.1.2.0 
netmask=255.255.255.192 
network address=10.1.2.64 


3.10 Loops: several iterators 


In most cases loops have only one iterator, but there could be several in the resulting 
code. 


Here is a very simple example: 


#include <stdio.h> 


void f(int *al, int *a2, size t cnt) 


{ 
size t i; 
// copy from one array to another in some weird scheme 
for (i=0; i<cnt; i++) 
al[i*3]=a2[i*7]; 
}; 


There are two multiplications at each iteration and they are costly operations. Can 
we optimize it somehow? 
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Yes, if we notice that both array indices are jumping on values that we can easily 
calculate without multiplication. 


3.10.1 Three iterators 


Listing 3.16: Optimizing MSVC 2013 x64 


f PROC 

; RCX=al 

; RDX=a2 

; R8=cnt 
test r8, r8 ; cnt==0? exit then 
je SHORT $LN1@f 
npad 11 

$LL3@f : 
mov eax, DWORD PTR [rdx] 
lea rcx, QWORD PTR [rcx+12] 
lea rdx, QWORD PTR [rdx+28] 
mov DWORD PTR [rcx-12], eax 
dec r8 
jne SHORT $LL3@f 

$LN1@f : 
ret 0 

f ENDP 


Now there are 3 iterators: the cnt variable and two indices, which are increased by 
12 and 28 at each iteration. We can rewrite this code in C/C++: 


#include <stdio.h> 


void f(int *al, int *a2, size t cnt) 
{ 
size t i; 
size t idx1=0; idx2=0; 


// copy from one array to another in some weird scheme 
for (i20; i<cnt; i++) 
1 
al[idx1]=a2[idx2]; 
idx1+=3; 
idx2+=7; 
$; 
$; 


So, at the cost of updating 3 iterators at each iteration instead of one, we can remove 
two multiplication operations. 


3.10.2 Two iterators 


GCC 4.9 does even more, leaving only 2 iterators: 
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Listing 3.17: Optimizing GCC 4.9 x64 


; RDI=al 

; RSI=a2 

; RDX=cnt 

f: 
test rdx, rdx ; cnt==0? exit then 
je .L1 

; calculate last element address in "a2" and leave it in RDX 
lea rax, [0+rdx*4] 

; RAX=RDX*4=cnt*4 
sal rdx, 5 

; RDX=RDX<<5=cnt*32 
sub rdx, rax 

; RDX=RDX-RAX=cnt*32-cnt*4=cnt*28 
add rdx, rsi 

; RDX=RDX+RSI=a2+cnt*28 

.L3: 
mov eax, DWORD PTR [rsi] 
add rsi, 28 
add rdi, 12 
mov DWORD PTR [rdi-12], eax 
cmp rsi, rdx 
jne .L3 

.L1: 
rep ret 


There is no counter variable any more: GCC concluded that it is not needed. 


The last element of the a2 array is calculated before the loop begins (which is easy: 
cnt * 7) and that’s how the loop is to be stopped: just iterate until the second index 
reaches this precalculated value. 


You can read more about multiplication using shifts/additions/subtractions here: 1.24.1 
on page 269. 


This code can be rewritten into C/C++ like that: 


#include <stdio.h> 


void f(int *al, int *a2, size t cnt) 
{ 
size t idx1=0; idx2=0; 
size t last idx2-cnt*7; 


// copy from one array to another in some weird scheme 
for (;;) 
{ 

al[idx1]=a2[idx2]; 

idx1+=3; 

idx2+=7; 

if (idx2--last idx2) 

break; 

}; 


F 
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GCC (Linaro) 4.9 for ARM64 does the same, but it precalculates the last index of a1 


instead of a2, which, of course has the same effect: 


Listing 3.18: Optimizing GCC (Linaro) 4.9 ARM64 


; X0-al 
; Xl=a2 
; X2=cnt 
f: 
cbz x2, .L1 ; cnt==0? exit then 
; calculate last element of "al" array 
add x2, x2, x2, isl 1 
; X2=X2+X2<<1=X2+X2*2=X2*3 
mov x3, 0 
Isl x2, x2, 2 
; X22X2««22X2*4zX2*3*4zX2*12 
.L3: 
ldr w4, [x1],28 ; load at X1, add 28 to X1 
(post-increment ) 
str w4, [x0,x3] ; store at X0+X3=a1+X3 
add x3, x3, 12 ; shift X3 
cmp x3, x2 ; end? 
bne .L3 
.L1: 
ret 


GCC 4.4.5 for MIPS does the same: 
Listing 3.19: Optimizing GCC 4.4.5 for MIPS (IDA) 


; $a0=al 
; $al=a2 
; $a2=cnt 
f: 
; jump to loop check code: 
begz $a2, locret 24 
; initialize counter (i) at 0: 
move $v0, $zero ; branch delay slot, NOP 
loc 8: 
; load 32-bit word at $al 
lw $a3, 0($al) 


; increment counter (i): 
addiu $v0, 1 
; check for finish (compare "i" in $v0 and "cnt" in $a2): 
sltu $v1, $v0, $a2 
; store 32-bit word at $a0: 
SW $a3, 0($a0) 
; add Ox1C (28) to $al at each iteration: 
addiu $al, Ox1C 
; jump to loop body if i<cnt: 
bnez $v1, loc 8 
; add OxC (12) to $a0 at each iteration: 
addiu $a0, OxC ; branch delay slot 
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locret 24: 
jr $ra 
or $at, $zero ; branch delay slot, NOP 


3.10.3 Intel C++ 2011 case 


Compiler optimizations can also be weird, but nevertheless, still correct. Here is 
what the Intel C++ compiler 2011 does: 


Listing 3.20: Optimizing Intel C++ 2011 x64 


f PROC 
; parameter 1: rcx = al 
; parameter 2: rdx = a2 
; parameter 3: r8 - cnt 
Bieli 
test r8, r8 
jbe exit 
.B1.2 
cmp r8, 6 
jbe just_copy 
.B1.3 
cmp rcx, rdx 
jbe .B1.5 
.B1.4 
mov r10, r8 
mov r9, rcx 
shl r10, 5 
lea rax, QWORD PTR [r8*4] 
sub r9, rdx 
sub r10, rax 
cmp r9, r10 
jge just copy2 
.B1.5 
cmp rdx, rcx 
jbe just copy 
.B1.6 
mov r9, rdx 
lea rax, QWORD PTR [r8*8] 
sub r9, rcx 
lea r10, QWORD PTR [rax+r8*4] 
cmp r9, r10 
jl just_copy 
just_copy2:: 
; R8 = cnt 
; RDX = a2 
; RCX = al 
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xor rlOd, rl10d 
xor r9d, r9d 
xor eax, eax 
.B1.8:: 
mov rlld, DWORD PTR [rax+rdx] 
inc r10 
mov DWORD PTR [r9+rcx], rlld 
add r9, 12 
add rax, 28 
cmp r10, r8 
jb .B1.8 
jmp exit 
just copy:: 
; R8 = cnt 
; RDX = a2 
; RCX = al 
xor rlOd, rl10d 
xor r9d, r9d 
xor eax, eax 
.B1.11:: 
mov rlld, DWORD PTR [rax+rdx] 
inc r10 
mov DWORD PTR [r9+rcx], rlld 
add rg, 12 
add rax, 28 
cmp r10, r8 
jb .B1.11 
exit:: 
ret 


First, there are some decisions taken, then one of the routines is executed. 
Looks like it is a check if arrays intersect. 


This is very well known way of optimizing memory block copy routines. But copy 
routines are the same! 


This is has to be an error of the Intel C++ optimizer, which still produces workable 
code, though. 


We intentionally considering such example code in this book so the reader would 
understand that compiler output is weird at times, but still correct, because when 
the compiler was tested, it passed the tests. 


3.11 Duff's device 


Duff's device is an unrolled loop with the possibility to jump to the middle of it. The 
unrolled loop is implemented using a fallthrough switch() statement. We would use 
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here a slightly simplified version of Tom Duff's original code. Let's say, we have to 
write a function that clears a region in memory. One can come with a simple loop, 
clearing byte by byte. It's obviously slow, since all modern computers have much 
wider memory bus. So the better way is to clear the memory region using 4 or 8 
bytes blocks. Since we are going to work with a 64-bit example here, we are going 
to clear the memory in 8 bytes blocks. So far so good. But what about the tail? 
Memory clearing routine can also be called for regions of size that's not a multiple 
of 8. So here is the algorithm: 


* calculate the number of 8-bytes blocks, clear them using 8-bytes (64-bit) mem- 
Ory accesses; 


* calculate the size of the tail, clear it using 1-byte memory accesses. 


The second step can be implemented using a simple loop. But let's implement it as 
an unrolled loop: 


#include <stdint.h> 
#include <stdio.h> 


void bzero(uint8 t* dst, size t count) 


{ 

int i; 

if (count&(~7) ) 
// work out 8-byte blocks 
for (i=0; i<count>>3; i++) 
{ 

*(uint64 t*)dst-0; 
dst=dst+8; 

un 

// work out the tail 

switch(count & 7) 

1 

case 7: *dst++ = 0; 

case 6: *dst++ = 0; 

case 5: *dst++ = 0; 

case 4: *dst++ = 0; 

case 3: *dst++ = 0; 

case 2: *dst++ = 0; 

case 1: *dst++ = 0; 

case 0: // do nothing 
break; 

} 

} 


Let's first understand how the calculation is performed. The memory region size 
comes as a 64-bit value. And this value can be divided in two parts: 


7 6 5 4 3 2 1 0 


BIBIBIBBISISIS 


( "B" is number of 8-byte blocks and "S" is length of the tail in bytes ). 
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When we divide the input memory region size by 8, the value is just shifted right by 
3 bits. But to calculate the remainder, we can just to isolate the lowest 3 bits! So the 
number of 8-byte blocks is calculated as count >> 3 and remainder as count&7. We also 
have to find out if we are going to execute the 8-byte procedure at all, so we need to 
check if the value of count is greater than 7. We do this by clearing the 3 lowest bits 
and comparing the resulting number with zero, because all we need here is to answer 
the question, is the high part of count non-zero. Of course, this works because 8 is 
2? and division by numbers that are 2" is easy. It's not possible for other numbers. 
It's actually hard to say if these hacks are worth using, because they lead to hard- 
to-read code. However, these tricks are very popular and a practicing programmer, 
even if he/she is not using them, nevertheless has to understand them. 


So the first part is simple: get the number of 8-byte blocks and write 64-bit zero 
values to memory. The second part is an unrolled loop implemented as fallthrough 
switch() statement. 


First, let’s express in plain English what we have to do here. 


We have to “write as many zero bytes in memory, as count&7 value tells us". If it's 
0, jump to the end, there is no work to do. If it's 1, jump to the place inside switch() 
statement where only one storage operation is to be executed. If it's 2, jump to 
another place, where two storage operation are to be executed, etc. 7 as input 
value leads to the execution of all 7 operations. There is no 8, because a memory 
region of 8 bytes is to be processed by the first part of our function. So we wrote 
an unrolled loop. It was definitely faster on older computers than normal loops (and 
conversely, latest CPUs works better for short loops than for unrolled ones). Maybe 
this is still meaningful on modern low-cost embedded MCU?s. 


Let's see what the optimizing MSVC 2012 does: 


dst$ = 8 
count$ = 16 
bzero PROC 
test rdx, -8 
je SHORT $LN11@bzero 
; work out 8-byte blocks 
xor r1Qd, rl0d 
mov r9, rdx 
shr r9, 3 
mov r8d, rl0d 
test r9, r9 
je SHORT $LN11@bzero 
npad 5 
$LL19@bzero: 
inc r8d 
mov QWORD PTR [rcx], r10 
add rcx, 8 
movsxd rax, r8d 
cmp rax, r9 
jb SHORT $LL19@bzero 
$LN11@bzero: 


; work out the tail 


9Microcontroller Unit 
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and edx, 7 
dec rdx 
cmp rdx, 6 
ja SHORT $LN9@bzero 
lea r8, OFFSET FLAT:  ImageBase 
mov eax, DWORD PTR $LN22@bzero[r8+rdx*4] 
add rax, r8 
jmp rax 
$LN8@bzero: 
mov BYTE PTR [rcx], 0 
inc rcx 
$LN7@bzero: 
mov BYTE PTR [rcx], 0 
inc rcx 
$LN6@bzero: 
mov BYTE PTR [rcx], 0 
inc rcx 
$LN5@bzero: 
mov BYTE PTR [rcx], 0 
inc rcx 
$LN4@bzero: 
mov BYTE PTR [rcx], 0 
inc rcx 
$LN3@bzero: 
mov BYTE PTR [rcx], 0 
inc rcx 
$LN2Gbzero: 
mov BYTE PTR [rcx], 0 
$LN9@bzero: 
fatret 0 
npad 1 
$LN22@bzero: 
DD $LN2@bzero 
DD $LN3@bzero 
DD $LN4@bzero 
DD $LN5@bzero 
DD $LN6@bzero 
DD $LN7@bzero 
DD $LN8@bzero 
bzero ENDP 


The first part of the function is predictable. The second part is just an unrolled loop 
and a jump passing control flow to the correct instruction inside it. There is no other 
code between the MOV/INC instruction pairs, so the execution is to fall until the very 
end, executing as many pairs as needed. By the way, we can observe that the 
MOV/INC pair consumes a fixed number of bytes (343). So the pair consumes 6 
bytes. Knowing that, we can get rid of the switch() jumptable, we can just multiple 
the input value by 6 and jump to current. RIP + input value +» 6. 


This can also be faster because we are not in need to fetch a value from the jumpt- 
able. 


It’s possible that 6 probably is not a very good constant for fast multiplication and 
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maybe it's not worth it, but you get the idea. 


That is what old-school demomakers did in the past with unrolled loops. 


3.11.1 Should one use unrolled loops? 


Unrolled loops can have benefits if there is no fast cache memory between RAM and 
CPU, and the CPU, in order to get the code of the next instruction, must load it from 
RAM each time. This is a case of modern low-cost MCU and old CPUs. 


Unrolled loops are slower than short loops if there is a fast cache between RAM and 
CPU and the body of loop can fit into cache, and CPU will load the code from it not 
touching the RAM. Fast loops are the loops which body's size can fit into L1 cache, 
but even faster loops are those small ones which can fit into micro-operation cache. 


3.12 Division using multiplication 


A very simple function: 


int f(int a) 


1 

return a/9; 
F; 
3.12.1 x86 


...is compiled in a very predictable way: 


Listing 3.21: MSVC 


_ag = 8 ; size = 4 

_f PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
cdq ; sign extend EAX to EDX:EAX 
mov ecx, 9 
idiv ecx 
pop ebp 
ret 0 

f ENDP 


IDIV divides the 64-bit number stored in the EDX: EAX register pair by the value in the 
ECX. As a result, EAX will contain the quotient, and EDX— the remainder. The result 
is returned from the f () function in the EAX register, so the value is not moved after 
the division operation, it is in right place already. 


10As an exercise, you can try to rework the code to get rid of the jumptable. The instruction pair can 
be rewritten in a way that it will consume 4 bytes or maybe 8. 1 byte is also possible (using STOSB 
instruction). 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


622 
Since IDIV uses the value in the EDX: EAX register pair, the CDQ instruction (before 
IDIV) extends the value in EAX to a 64-bit value taking its sign into account, just as 
MOVSX does. 


If we turn optimization on (/0x), we get: 


Listing 3.22: Optimizing MSVC 


_a$ = 8 ; size = 4 
_f PROC 
mov ecx, DWORD PTR a$[esp-4] 
mov eax, 954437177 ; 38e38e39H 
imul ecx 
sar edx, 1 
mov eax, edx 
shr eax, 31 ; 0000001fH 
add eax, edx 
ret 0 
f ENDP 


This is division by multiplication. Multiplication operations work much faster. And 
it is possible to use this trick ** to produce code which is effectively equivalent and 
faster. 


This is also called "strength reduction" in compiler optimizations. 


GCC 4.4.1 generates almost the same code even without additional optimization 
flags, just like MSVC with optimization turned on: 


Listing 3.23: Non-optimizing GCC 4.4.1 


public f 
f proc near 


arg 0 - dword ptr 8 


push ebp 
mov ebp, esp 
mov ecx, [ebp«arg 0] 
mov edx, 954437177 ; 38E38E39h 
mov eax, ecx 
imul edx 
sar edx, 1 
mov eax, ecx 
sar eax, 1Fh 
mov ecx, edx 
sub ecx, eax 
mov eax, ecx 
pop ebp 
retn 
f endp 


11Read more about division by multiplication in [Henry S. Warren, Hacker’s Delight, (2002)10-3] 
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3.12.2 How it works 


From school-level mathematics, we can remember that division by 9 can be replaced 
by multiplication by i. In fact, sometimes compilers do so for floating-point arith- 
metics, for example, FDIV instruction in x86 code can be replaced by FMUL. At least 
MSVC 6.0 will replace division by 9 by multiplication by 0.111111... and sometimes it's 
hard to be sure, what operation was in the original source code. 


But when we operate over integer values and integer CPU registers, we can't use 
fractions. However, we can rework fraction like that: 


—# 24.1 24.1 MagicNumber 
result — 9-T'yg—7 9.MagicN umber 


Given the fact that division by 2" is very fast (using shifts), we now should find that 
MagicN umber, for which the following equation will be true: 2” = 9- MagicNumber. 


Division by 2?? is somewhat hidden: lower 32-bit of product in EAX is not used 
(dropped), only higher 32-bit of product (in EDX) is used and then shifted by ad- 
ditional 1 bit. 


In other words, the assembly code we have just seen multiplicates by Ip or 


324-1 
divides by SAT To find a divisor we just have to divide numerator by denomi- 


nator. Using Wolfram Alpha, we can get 8.99999999.... as result (which is close to 
9). 


Read more about it in [Henry S. Warren, Hacker's Delight, (2002)10-3]. 


Many people miss "hidden" division by 2% or 26t, when lower 32-bit part (or 64- 
bit part) of product is not used. This is why division by multiplication is difficult to 
understand at the beginning. 


, 


Mathematical Recipes!?has yet another explanation. 


3.12.3 ARM 


The ARM processor, just like in any other "pure" RISC processor lacks an instruction 
for division. It also lacks a single instruction for multiplication by a 32-bit constant 
(recall that a 32-bit constant cannot fit into a 32-bit opcode). 


By taking advantage of this clever trick (or hack), it is possible to do division using 
only three instructions: addition, subtraction and bit shifts (1.28 on page 382). 


Here is an example that divides a 32-bit number by 10, from [Advanced RISC Ma- 
chines Ltd, The ARM Cookbook, (1994)3.3 Division by a Constant]. The output con- 
sists of the quotient and the remainder. 


; takes argument in al 

; returns quotient in al, remainder in a2 

; Cycles could be saved if only divide or remainder is required 
SUB a2, al, £10 ; keep (x-10) for later 
SUB al, al, al, lsr #2 
ADD al, al, al, lsr #4 


Phttps://math.recipes 
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ADD al, al, al, lsr #8 
ADD al, al, al, lsr #16 
MOV al, al, lsr #3 


- 


ADD a3, al, al, asl #2 

SUBS a2, a2, a3, asl #1 ; calc (x-10) - (x/10)*10 
ADDPL al, al, #1 ; fix-up quotient 

ADDMI a2, a2, #10 ; fix-up remainder 


MOV pc, lr 


Optimizing Xcode 4.6.3 (LLVM) (ARM mode) 


. text:00002C58 39 1E 08 E3 E3 18 43 E3 MOV R1, 0x38E38E39 


. text:00002C60 10 F1 50 E7 SMMUL RO, RO, R1 

. text:00002C64 CO 10 AQ El MOV R1, RO, ASR*1 

. text:00002C68 AO OF 81 EO ADD RO, R1, RO,LSR#31 
. text:00002C6C 1E FF 2F El BX LR 


This code is almost the same as the one generated by the optimizing MSVC and GCC. 
Apparently, LLVM uses the same algorithm for generating constants. 


The observant reader may ask, how does MOV writes a 32-bit value in a register, when 
this is not possible in ARM mode. 


it is impossible indeed, but, as we see, there are 8 bytes per instruction instead of 
the standard 4, in fact, there are two instructions. 


The first instruction loads 0x8E39 into the low 16 bits of register and the second 
instruction is MOVT, it loads 0x383E into the high 16 bits of the register. IDA is fully 
aware of such sequences, and for the sake of compactness reduces them to one 
single "pseudo-instruction". 


The SMMUL (Signed Most Significant Word Multiply) instruction two multiplies num- 
bers, treating them as signed numbers and leaving the high 32-bit part of result in 
the RO register, dropping the low 32-bit part of the result. 


The"MOV R1, RO,ASR#1” instruction is an arithmetic shift right by one bit. 
"ADD RO, R1, RO,LSR#31” is RO= R1+ R0»»31 


There is no separate shifting instruction in ARM mode. Instead, an instructions like 
(MOV, ADD, SUB, RSB)?? can have a suffix added, that says if the second operand must 
be shifted, and if yes, by what value and how. ASR stands for Arithmetic Shift Right, 
LSR—Logical Shift Right. 


Optimizing Xcode 4.6.3 (LLVM) (Thumb-2 mode) 


MOV R1, 0x38E38E39 
SMMUL . W RO, RO, R1 

ASRS R1, RO, #1 

ADD.W RO, R1, RO,LSR#31 
BX LR 


13These instructions are also called “data processing instructions” 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


625 


There are separate instructions for shifting in Thumb mode, and one of them is used 
here—ASRS (arithmetic shift right). 


Non-optimizing Xcode 4.6.3 (LLVM) and Keil 6/2013 


Non-optimizing LLVM does not generate the code we saw before in this section, but 
instead inserts a call to the library function  divsi3. 


What about Keil: it inserts a call to the library function aeabi idivmod in all cases. 


3.12.4 MIPS 
For some reason, optimizing GCC 4.4.5 generate just a division instruction: 


Listing 3.24: Optimizing GCC 4.4.5 (IDA) 


T 

li $v0, 9 

bnez $v0, loc 10 

div $a0, $v0 ; branch delay slot 

break 0x1C00 ; "break 7" in assembly output and objdump 
loc 10: 

mflo $v0 

jr $ra 

or $at, $zero ; branch delay slot, NOP 


Here we see here a new instruction: BREAK. It just raises an exception. 


In this case, an exception is raised if the divisor is zero (it's not possible to divide by 
zero in conventional math). 


But GCC probably did not do very well the optimization job and did not see that $VO 
is never zero. 


So the check is left here. So if $VO is zero somehow, BREAK is to be executed, 
signaling to the OS about the exception. 


Otherwise, MFLO executes, which takes the result of the division from the LO register 
and copies it in $VO. 


By the way, as we may know, the MUL instruction leaves the high 32 bits of the result 
in register HI and the low 32 bits in register LO. 


DIV leaves the result in the LO register, and remainder in the HI register. 


If we alter the statement to "a 96 9", the MFHI instruction is to be used here instead 
of MFLO. 


3.12.5 Exercise 


* http://challenges.re/27 
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3.13 String to number conversion (atoi()) 
Let's try to reimplement the standard atoi() C function. 


3.13.1 Simple example 


Here is the simplest possible way to read a number represented in ASCII encoding. 
It’s not error-prone: a character other than a digit leads to incorrect result. 


#include <stdio.h> 


int my_atoi (char *s) 


{ 
int rt=0; 
while (*s) 
{ 
rt=rt*10 + (*s-'0'); 
Stt; 
y; 
return rt; 
y; 
int main() 
1 
printf ("%d\n", my atoi ("1234")); 
printf ("%d\n", my atoi ("1234567890")); 
H 


So what the algorithm does is just reading digits from left to right. 
The zero ASCII character is subtracted from each digit. 


The digits from “0” to "9" are consecutive in the ASCII table, so we do not even need 
to know the exact value of the "0" character. 


All we have to know is that “0” minus “0” is O, "9" minus "O"'is 9 and so on. 
Subtracting “0” from each character results in a number from 0 to 9 inclusive. 
Any other character leads to an incorrect result, of course! 


Each digit has to be added to the final result (in variable "rt"), but the final result is 
also multiplied by 10 at each digit. 


In other words, the result is shifted left by one position in decimal form on each 
iteration. 


The last digit is added, but there is no shift. 


Optimizing MSVC 2013 x64 
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Listing 3.25: Optimizing MSVC 2013 x64 


s$ = 8 
my atoi PROC 
; load first character 

movzx r8d, BYTE PTR [rcx] 
; EAX is allocated for "rt" variable 
; its 0 at start 


xor eax, eax 
; first character is zero-byte, i.e., string terminator? 
; exit then. 

test r8b, r8b 

je SHORT $LN9@my atoi 
$LL2@my atoi: 

lea edx, DWORD PTR [rax+rax*4] 


; EDX=RAX+RAX*4=rt+rt*4=rt*5 
movsx eax, r8b 
EAX=input character 
load next character to R8D 
movzx r8d, BYTE PTR [rcx+1] 
shift pointer in RCX to the next character: 
lea rcx, QWORD PTR [rcx+1] 
lea eax, DWORD PTR [rax+rdx*2] 
EAX=RAX+RDX*2=input character + rt*5*2=input character + rt*10 
; correct digit by subtracting 48 (0x30 or '0') 
add eax, -48 ; ffffffffffffffdOH 
; was the last character zero? 
test r8b, r8b 
; jump to loop begin, if not 


jne SHORT $LL2Gmy atoi 
$LN9Gmy atoi: 
ret 0 


my atoi ENDP 


A character can be loaded in two places: the first character and all subsequent 
characters. This is arranged so for loop regrouping. 


There is no instruction for multiplication by 10, two LEA instruction do this instead. 


MSVC sometimes uses the ADD instruction with a negative constant instead of SUB. 
This is the case. 


It’s very hard to say why this is better then SUB. But MSVC does this often. 


Optimizing GCC 4.9.1 x64 


Optimizing GCC 4.9.1 is more concise, but there is one redundant RET instruction at 
the end. One would be enough. 


Listing 3.26: Optimizing GCC 4.9.1 x64 


my atoi: 

; load input character into EDX 
movsx edx, BYTE PTR [rdi] 

; EAX is allocated for "rt" variable 
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xor eax, eax 
; exit, if loaded character is null byte 
test dl, dl 
je .L4 
.L3: 
lea eax, [rax+rax*4] 
; EAX=RAX*5=rt*5 
; shift pointer to the next character: 
add rdi, 1 
lea eax, [rdx-48+rax*2] 
; EAX=input character - 48 + RAX*2 = input character - '0' + rt*10 
; load next character: 
movsx edx, BYTE PTR [rdi] 
; goto loop begin, if loaded character is not null byte 
test dl, dl 
jne .L3 
rep ret 
.L4: 
rep ret 


Optimizing Keil 6/2013 (ARM mode) 


Listing 3.27: Optimizing Keil 6/2013 (ARM mode) 


my atoi PROC 
; R1 will contain pointer to character 


MOV r1,r0 
; RO will contain "rt" variable 
MOV ro,*0 
B [L0.28| 
[L0.12| 
ADD r0,r0,r0,LSL #2 
; RO=RO+RO<<2=rt*5 
ADD r0,r2,r0,LSL #1 


; RO-input character + rt*5««1 = input character + rt*10 
; correct whole thing by subtracting '0' from rt: 


SUB r0,r0,*0x30 
; shift pointer to the next character: 
ADD rl,rl1,41 
[L0.28| 
; load input character to R2 
LDRB r2,[r1,#0] 
; is it null byte? if no, jump to loop body. 
CMP r2,*+0 
BNE [L0.12| 


; exit if null byte. 

; "rt" variable is still in RO register, ready to be used in caller function 
BX lr 
ENDP 


Optimizing Keil 6/2013 (Thumb mode) 
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Listing 3.28: Optimizing Keil 6/2013 (Thumb mode) 


my atoi PROC 
; R1 will be pointer to the input character 


MOVS r1,r0 
; RO is allocated to "rt" variable 
MOVS ro,*0 
B [L0.16| 
[L0.6| 
MOVS r3,*0xa 
; R3=10 
MULS r0,r3,r0 


; RO=R3*RO=rt*10 
; shift pointer to the next character: 


ADDS r1,r1,#1 
; correct whole thing by subtracting '0' character from it: 
SUBS r0,r0,*0x30 
ADDS r0,r2,r0 
; rt=R2+R0=input character + (rt*10 - '0') 
[L0.16| 
; load input character to R2 
LDRB r2,[r1,40] 
; is it zero? 
CMP r2,#0 
; jump to loop body if it is not 
BNE |LO.6| 
; rt variable in RO now, ready to be used in caller function 
BX lr 
ENDP 


Interestingly, from school mathematics we may recall that the order of addition and 
subtraction operations doesn't matter. 


That's our case: first, the rt«10-'0' expression is computed, then the input character 
value is added to it. 


Indeed, the result is the same, but the compiler did some regrouping. 


Optimizing GCC 4.9.1 ARM64 
The ARM64 compiler can use the pre-increment instruction suffix: 


Listing 3.29: Optimizing GCC 4.9.1 ARM64 


my atoi: 

; load input character into W1 
ldrb wl, [x0] 
mov x2, x0 

X2-address of input string 

is loaded character zero? 

; jump to exit if its so 

; Wl will contain 0 in this case. 

it will be reloaded into WO at L4. 
cbz wl, .L4 

; WO will contain "rt" variable 
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; initialize it at zero: 


mov w0, 0 

.L3: 

; subtract 48 or '0' from input variable and put result into W3: 
sub w3, wl, #48 


; load next character at address X241 into W1 with pre-increment: 
ldrb wl, [x2,1]! 
add w0, w0, wO, lsl 2 
; WO=W0+W0<<2=W0+W0*4=rt*5 
add w0, w3, w0, lsl 1 
WO-input digit + WO<<1 = input digit + rt*5*2 = input digit + rt*10 
; if the character we just loaded is not null byte, jump to the loop begin 
cbnz wl, .L3 
variable to be returned (rt) is in WO, ready to be used in caller function 
ret 


.L4: 
mov w0, wl 
ret 


3.13.2 A slightly advanced example 


My new code snippet is more advanced, now it checks for the “minus” sign at the 
first character and reports an error if a non-digit has been found in the input string: 


#include <stdio.h> 


int my atoi (char *s) 


1 

int negative-0; 

int rt-0; 

if (*s=='-') 

1 
negative-1; 
Stt; 

y; 

while (*s) 

1 
if (*s«'0' || *s>'9') 
1 

printf ("Error! Unexpected char: '%c'\n", *s); 
exit(0); 

y; 
rt=rt*10 + (*s-'0'); 
Stt; 

y; 

if (negative) 
return -rt; 

return rt; 

y; 
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int main() 
1 

printf ("%d\n", my atoi ("1234")); 

printf ("%d\n", my atoi ("1234567890")); 

printf ("%d\n", my atoi ("-1234")); 

printf ("%d\n", my atoi ("-1234567890")); 

printf ("%d\n", my atoi ("-a1234567890")); // error 
3 


Optimizing GCC 4.9.1 x64 
Listing 3.30: Optimizing GCC 4.9.1 x64 


.LC0: 
.string "Error! Unexpected char: ‘%c'\n" 


my atoi: 

sub rsp, 8 

movsx edx, BYTE PTR [rdi] 
; check for minus sign 


cmp dl, 45 ; '-' 
je .L22 
xor esi, esi 
test dl, dl 
je .L20 
.L10: 
; ESI=0 here if there was no minus sign and 1 if it was 
lea eax, [rdx-48] 


any character other than digit will result 

in unsigned number greater than 9 after subtraction 
; so if it is not digit, jump to L4, 

where error will be reported: 


cmp al, 9 
ja .L4 
xor eax, eax 
jmp .L6 
.L7: 
lea ecx, [rdx-48] 
cmp cl, 9 
ja .L4 
.L6: 
lea eax, [rax+rax*4] 
add rdi, 1 
lea eax, [rdx-48+rax*2] 


movsx edx, BYTE PTR [rdi] 

test dl, dl 

jne .L7 
; if there was no minus sign, skip NEG instruction 
; if it was, execute it. 


test esi, esi 
je .L18 
neg eax 
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.L18: 
add rsp, 8 
ret 
.L22: 
movsx edx, BYTE PTR [rdi+1] 
lea rax, [rdi+1] 
test dl, dl 
je .L20 
mov rdi, rax 
mov esi, 1 
jmp .L10 
.L20: 
xor eax, eax 
jmp .L18 
.L4: 
; report error. character is in EDX 
mov edi, 1 
mov esi, OFFSET FLAT:.LCO ; "Error! Unexpected char: ‘%c'\n" 
xor eax, eax 
call . printf chk 
xor edi, edi 
call exit 


If the "minus" sign has been encountered at the string start, the NEG instruction is 
to be executed at the end. It just negates the number. 


There is one more thing that needs mentioning. 


How would a common programmer check if the character is not a digit? Just how we 
have it in the source code: 


if (*s«'0' || *s>'9') 


There are two comparison operations. 


What is interesting is that we can replace both operations by single one: just subtract 
“0” from character value, 


treat result as unsigned value (this is important) and check if it's greater than 9. 


un 


For example, let's say that the user input contains the dot character (“.”) which has 
ASCII code 46. 46 - 48 — -2 if we treat the result as a signed number. 


Indeed, the dot character is located two places earlier than the “0” character in the 
ASCII table. But it is OXFFFFFFFE (4294967294) if we treat the result as an unsigned 
value, and that's definitely bigger than 9! 


The compilers do this often, so it's important to recognize these tricks. 
Another example of it in this book: 3.19.1 on page 672. 
Optimizing MSVC 2013 x64 does the same tricks. 
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Optimizing Keil 6/2013 (ARM mode) 


Listing 3.31: Optimizing Keil 6/2013 (ARM mode) 


my atoi PROC 


PUSH {r4-r6, lr} 
MOV r4,r0 
LDRB ro, [r0, #0] 
MOV r6,#0 
MOV r5,r6 
CMP r0,#0x2d '-' 
; R6 will contain 1 if minus was encountered, 0 if otherwise 
MOVEQ r6,#1 
ADDEQ r4,r4,#1 
B |LO.80| 
[L0.36| 
SUB r0,r1,#0x30 
CMP r0,#0xa 
BCC |LO.64| 
ADR r0,|L0.220| 
BL _ 2printf 
MOV r0,#0 
BL exit 
[L0.64| 
LDRB r0,[r4],#1 
ADD rl,r5,r5,LSL #2 
ADD r0,r0,r1,LSL #1 
SUB r5,r0,#0x30 
|LO.80| 
LDRB rl, [r4,#0] 
CMP r1,#0 
BNE [L0.36| 
CMP r6,#0 
; negate result 
RSBNE r0,r5,#0 
MOVEQ ro,r5 
POP {r4-r6,pc} 
ENDP 
|LO.220| 
DCB "Error! Unexpected char: '%c'\n",0 


There is no NEG instruction in 32-bit ARM, so the “Reverse Subtraction” operation 
(line 31) is used here. 


It is triggered if the result of the CMP instruction (at line 29) has been “Not Equal” 
(hence -NE suffix). 


So what RSBNE does is to subtract the resulting value from O. 


It works just like the regular subtraction operation, but swaps operands. 


Subtracting any number from 0 results in negation: 0-2 = -z. 


Thumb mode code is mostly the same. 
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GCC 4.9 for ARM64 can use the NEG instruction, which is available in ARM64. 


3.13.3 Exercise 


Oh, by the way, security researchers deals often with unpredictable behavior of pro- 
gram while handling of incorrect data. 


For example, while fuzzing. As an exercise, you may try to enter non-digit characters 
and see what happens. 


Try to explain, what happened and why. 


3.14 Inline functions 


Inlined code is when the compiler, instead of placing a call instruction to a small or 
tiny function, just places its body right in-place. 


Listing 3.32: A simple example 


#include <stdio.h> 


int celsius to fahrenheit (int celsius) 


{ 
return celsius * 9/5 + 32; 
}; 
int main(int argc, char *argv[]) 
{ 
int celsius=atol(argv[1]); 
printf ("%d\n", celsius_to fahrenheit (celsius)); 
}; 


..is compiled in very predictable way, however, if we turn on GCC optimizations 
(-03), we'll see: 


Listing 3.33: Optimizing GCC 4.8.1 


main: 
push ebp 
mov ebp, esp 
and esp, -16 
sub esp, 16 
call |. main 
mov eax, DWORD PTR [ebp+12] 
mov eax, DWORD PTR [eax+4] 
mov DWORD PTR [esp], eax 
call  atol 
mov edx, 1717986919 
mov DWORD PTR [esp], OFFSET FLAT:LC2 ; "%d\n" 
lea ecx, [eax+eax*8] 
mov eax, ecx 
imul edx 
sar ecx, 31 
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sar edx 

sub edx, ecx 

add edx, 32 

mov DWORD PTR [esp+4], edx 
call _ printf 

leave 

ret 


(Here the division is performed by multiplication(3.12 on page 621).) 


Yes, our small function celsius to fahrenheit() has just been placed before the 
printf () call. 


Why? It can be faster than executing this function’s code plus the overhead of call- 
ing/returning. 


Modern optimizing compilers are choosing small functions for inlining automatically. 
But it’s possible to force compiler additionally to inline some function, if to mark it 
with the “inline” keyword in its declaration. 


3.14.1 Strings and memory functions 


Another very common automatic optimization tactic is the inlining of string functions 
like strcpy(), strcmp(), strlen(), memset(), memcmp(), memcpy(), etc.. 


Sometimes it’s faster than to call a separate function. 


These are very frequent patterns and it is highly advisable for reverse engineers to 
learn to detect automatically. 


strcmp() 


Listing 3.34: strcmp() example 


bool is bool (char *s) 


{ 
if (strcmp (s, "true")==0) 
return true; 
if (strcmp (s, "false")==0) 
return false; 
assert(0); 
}; 
Listing 3.35: Optimizing GCC 4.8.1 
.LC0: 
.string "true" 
.LC1: 
.string "false" 
is bool: 
. LFBO: 


push edi 
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mov ecx, 5 
push esi 
mov edi, OFFSET FLAT: .LCO 
sub esp, 20 
mov esi, DWORD PTR [esp+32] 
repz cmpsb 
je .L3 
mov esi, DWORD PTR [esp+32] 
mov ecx, 6 
mov edi, OFFSET FLAT: .LC1 
repz cmpsb 
seta cl 
setb dl 
xor eax, eax 
cmp cl, dl 
jne .L8 
add esp, 20 
pop esi 
pop edi 
ret 
.L8: 
mov DWORD PTR [esp], 0 
call assert 
add esp, 20 
pop esi 
pop edi 
ret 
.L3: 
add esp, 20 
mov eax, 1 
pop esi 
pop edi 
ret 
Listing 3.36: Optimizing MSVC 2010 
$5G3454 DB 'true', 00H 
$5G3456 DB 'false', 00H 
_s$ = 8 ; size = 4 
?is bool@@YA NPAD@Z PROC ; is bool 
push esi 
mov esi, DWORD PTR s$[esp] 
mov ecx, OFFSET $5G3454 ; 'true' 
mov eax, esi 


npad 4 ; align next label 
$LL6Gis bool: 


mov dl, BYTE PTR [eax] 
cmp dl, BYTE PTR [ecx] 
jne SHORT $LN7@is_ bool 
test dl, dl 

je SHORT $LN8@is_ bool 
mov dl, BYTE PTR [eax+1] 
cmp dl, BYTE PTR [ecx+1] 
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jne 
add 
add 
test 
jne 
$LN8Gis bool: 
xor 


jmp 
$LN7Gis bool: 
sbb 
sbb 
$LN9Qis bool: 
test 
jne 


mov 
pop 


ret 
$LN2Gis bool: 


mov 
mov 
$LL10@is bool: 
mov 
cmp 
jne 
test 
je 
mov 
cmp 
jne 
add 
add 
test 
jne 
$LN12@is bool: 
xor 
jmp 
$LN11@is bool: 
sbb 
sbb 
$LN13@is bool: 
test 
jne 


xor 
pop 


ret 
$LN1Gis bool: 


push 


SHORT $LN7Qis bool 
eax, 2 
ecx, 2 
dl, dl 
SHORT $LL6@is_ bool 


eax, eax 
SHORT $LN9Gis bool 


eax, eax 
eax, -1 


eax, eax 
SHORT $LN2@is_ bool 


al, 1 
esi 


0 


ecx, OFFSET $SG3456 ; 'false' 
eax, esi 


dl, BYTE PTR [eax] 
dl, BYTE PTR [ecx] 
SHORT $LN11@is_ bool 
dl, dl 

SHORT $LN12Qis bool 
dl, BYTE PTR [eax+1] 
dl, BYTE PTR [ecx+1] 
SHORT $LN11Qis bool 
eax, 2 

ecx, 2 

dl, dl 

SHORT $LL10@is_ bool 


eax, eax 
SHORT $LN13Qis bool 


eax, eax 
SHORT $LN1Gis bool 


al, al 
esi 


0 


11 
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push OFFSET $56G3458 
push OFFSET $56G3459 
call DWORD PTR imp  wassert 


add esp, 12 
pop esi 
ret 0 


?is bool@@YA_NPAD@Z ENDP ; is bool 


strlen() 


Listing 3.37: strlen() example 


int strlen test(char *s1) 


1 
ur 


return strlen(s1); 


Listing 3.38: Optimizing MSVC 2010 


_s1$ = 8 ; size = 4 
_strlen_ test PROC 


mov eax, DWORD PTR si$[esp-4] 

lea edx, DWORD PTR [eax+1] 
$LL3@strlen_tes: 

mov cl, BYTE PTR [eax] 

inc eax 

test cl, cl 

jne SHORT $LL3@strlen_ tes 

sub eax, edx 

ret 0 


_strlen_ test ENDP 


strcpy() 


Listing 3.39: strcpy() example 


void strcpy test(char *s1, char *outbuf) 


strcpy(outbuf, s1); 


i 
Listing 3.40: Optimizing MSVC 2010 
_sl$ = 8 ; size = 4 
_outbuf$ = 12 ; size = 4 
_strcpy_test PROC 
mov eax, DWORD PTR si$[esp-4] 
mov edx, DWORD PTR _outbuf$[esp-4] 


sub edx, eax 
npad 6 ; align next label 
$LL3@strcpy_tes: 
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mov cl, BYTE PTR [eax] 

mov BYTE PTR [edx+eax], cl 
inc eax 

test cl, cl 

jne SHORT $LL3Gstrcpy tes 
ret 0 


 Strcpy test ENDP 


memset() 


Example#1 


Listing 3.41: 32 bytes 


#include <stdio.h> 


void f(char *out) 


{ 
y 


memset(out, 0, 32); 


Many compilers don't generate a call to memset() for short blocks, but rather insert 
a pack of MOVs: 


Listing 3.42: Optimizing GCC 4.9.1 x64 


f: 
mov QWORD PTR [rdi], 0 
mov QWORD PTR [rdi-8], 0 
mov QWORD PTR [rdi+16], 0 
mov QWORD PTR [rdi+24], 0 
ret 


By the way, that remind us of unrolled loops: 1.22.1 on page 241. 


Example#2 


Listing 3.43: 67 bytes 


#include <stdio.h> 


void f(char *out) 


{ 
Fi 


memset(out, 0, 67); 


When the block size is not a multiple of 4 or 8, the compilers can behave differently. 


For instance, MSVC 2012 continues to insert MOVs: 
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Listing 3.44: Optimizing MSVC 2012 x64 


out$ = 8 

f PROC 
xor eax, eax 
mov QWORD PTR [rcx], rax 
mov QWORD PTR [rcx+8], rax 
mov QWORD PTR [rcx+16], rax 
mov QWORD PTR [rcx+24], rax 
mov QWORD PTR [rcx+32], rax 
mov QWORD PTR [rcx+40], rax 
mov QWORD PTR [rcx+48], rax 
mov QWORD PTR [rcx+56], rax 
mov WORD PTR [rcx+64], ax 
mov BYTE PTR [rcx+66], al 
ret 0 

f ENDP 


...while GCC uses REP STOSQ, concluding that this would be shorter than a pack of 
MOVs: 


Listing 3.45: Optimizing GCC 4.9.1 x64 


f: 
mov QWORD PTR [rdi], 0 
mov QWORD PTR [rdi+59], 0 
mov rcx, rdi 
lea rdi, [rdi+8] 
xor eax, eax 
and rdi, -8 
sub rcx, rdi 
add ecx, 67 
shr ecx, 3 
rep stosq 
ret 
memcpy() 


Short blocks 


The routine to copy short blocks is often implemented as a sequence of MOV instruc- 
tions. 


Listing 3.46: memcpy() example 


void memcpy 7(char *inbuf, char *outbuf) 


{ 
F 


memcpy(outbuf+10, inbuf, 7); 


Listing 3.47: Optimizing MSVC 2010 


_inbuf$ = 8 ; size = 4 
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_outbuf$ = 12 ; size = 4 
 memcpy 7 PROC 
mov ecx, DWORD PTR  inbuf$[esp-4] 
mov edx, DWORD PTR [ecx] 
mov eax, DWORD PTR _outbuf$[esp-4] 
mov DWORD PTR [eax+10], edx 
mov dx, WORD PTR [ecx+4] 
mov WORD PTR [eax+14], dx 
mov cl, BYTE PTR [ecx+6] 
mov BYTE PTR [eax+16], cl 
ret 0 


 memcpy 7 ENDP 


Listing 3.48: Optimizing GCC 4.8.1 


memcpy 7: 
push ebx 
mov eax, DWORD PTR [esp+8] 
mov ecx, DWORD PTR [esp+12] 
mov ebx, DWORD PTR [eax] 
lea edx, [ecx+10] 
mov DWORD PTR [ecx+10], ebx 
movzx ecx, WORD PTR [eax+4] 
mov WORD PTR [edx+4], cx 
movzx eax, BYTE PTR [eax+6] 
mov BYTE PTR [edx+6], al 
pop ebx 
ret 


That’s usually done as follows: 4-byte blocks are copied first, then a 16-bit word (if 
needed), then the last byte (if needed). 


Structures are also copied using MOV: 1.30.4 on page 454. 


Long blocks 


The compilers behave differently in this case. 


Listing 3.49: memcpy() example 


void memcpy 128(char *inbuf, char *outbuf) 


{ 
memcpy(outbuf+10, inbuf, 128); 
}; 
void memcpy_123(char *inbuf, char *outbuf) 
{ 
memcpy(outbuf+10, inbuf, 123); 
}; 


For copying 128 bytes, MSVC uses a single MOVSD instruction (because 128 divides 
evenly by 4): 
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Listing 3.50: Optimizing MSVC 2010 


_inbuf$ = 8 ; size = 4 
_outbuf$ = 12 ; size = 4 
_memcpy_128 PROC 

push esi 

mov esi, DWORD PTR inbuf$[esp] 

push edi 

mov edi, DWORD PTR _outbuf$[esp+4] 

add edi, 10 

mov ecx, 32 

rep movsd 

pop edi 

pop esi 

ret 0 


 memcpy 128 ENDP 


When copying 123 bytes, 30 32-bit words are copied first using MOVSD (that's 120 
bytes), then 2 bytes are copied using MOVSW, then one more byte using MOVSB. 


Listing 3.51: Optimizing MSVC 2010 


_inbuf$ = 8 ; size = 4 
_outbuf$ = 12 ; size = 4 
_memcpy_123 PROC 

push esi 

mov esi, DWORD PTR _inbuf$[esp] 

push edi 

mov edi, DWORD PTR _outbuf$[esp+4] 

add edi, 10 

mov ecx, 30 

rep movsd 

movsw 

movsb 

pop edi 

pop esi 

ret 0 


 memcpy 123 ENDP 


GCC uses one big universal functions, that works for any block size: 


Listing 3.52: Optimizing GCC 4.8.1 


memcpy 123: 
.LFB3: 
push edi 
mov eax, 123 
push esi 
mov edx, DWORD PTR [esp+16] 
mov esi, DWORD PTR [esp+12] 
lea edi, [edx+10] 
test edi, 1 
jne .L24 
test edi, 2 
jne .L25 
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L7: 
mov ecx, eax 
xor edx, edx 
shr ecx, 2 
test al, 2 
rep movsd 
je .L8 
movzx edx, WORD PTR [esi] 
mov WORD PTR [edi], dx 
mov edx, 2 
.L8: 
test al, 1 
je .L5 
movzx eax, BYTE PTR [esi+edx] 
mov BYTE PTR [edi+edx], al 
.L5: 
pop esi 
pop edi 
ret 
.L24: 
movzx eax, BYTE PTR [esi] 
lea edi, [edx+11] 
add esi, 1 
test edi, 2 
mov BYTE PTR [edx+10], al 
mov eax, 122 
je .L7 
.L25: 
movzx edx, WORD PTR [esi] 
add edi, 2 
add esi, 2 
sub eax, 2 
mov WORD PTR [edi-2], dx 
jmp .L7 
.LFE3: 


Universal memory copy functions usually work as follows: calculate how many 32-bit 
words can be copied, then copy them using MOVSD, then copy the remaining bytes. 


More advanced and complex copy functions use SIMD instructions and also take the 
memory alignment in consideration. 


As an example of SIMD strlen() function: 1.36.2 on page 527. 


memcmp() 


Listing 3.53: memcmp() example 


int memcmp 1235(char *bufl, char *buf2) 
1 


ur 


return memcmp(bufl, buf2, 1235); 
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For any block size, MSVC 2013 inserts the same universal function: 


Listing 3.54: Optimizing MSVC 2010 


_buf1$ = 8 ; size = 4 
_buf2$ = 12 ; size = 4 
 memcmp 1235 PROC 
mov ecx, DWORD PTR  bufi$[esp-4] 
mov edx, DWORD PTR _buf2$[esp-4] 
push esi 
mov esi, 1231 
npad 2 
$LL5@memcmp_123: 
mov eax, DWORD PTR [ecx] 
cmp eax, DWORD PTR [edx] 
jne SHORT $LN4@memcmp_123 
add ecx, 4 
add edx, 4 
sub esi, 4 
jae SHORT $LL5@memcmp_123 
$LN4@memcmp_123: 
mov al, BYTE PTR [ecx] 
cmp al, BYTE PTR [edx] 
jne SHORT $LN6@memcmp_123 
mov al, BYTE PTR [ecx+1] 
cmp al, BYTE PTR [edx+1] 
jne SHORT $LN6@memcmp_123 
mov al, BYTE PTR [ecx+2] 
cmp al, BYTE PTR [edx+2] 
jne SHORT $LN6@memcmp_123 
cmp esi, -1 
je SHORT $LN3@memcmp_123 
mov al, BYTE PTR [ecx+3] 
cmp al, BYTE PTR [edx+3] 
jne SHORT $LN6@memcmp_123 
$LN3QGmemcmp 123: 
xor eax, eax 
pop esi 
ret 0 
$LN6Gmemcmp 123: 
sbb eax, eax 
or eax, 1 
pop esi 
ret 0 


 memcmp 1235 ENDP 


strcat() 


This is inlined strcat() as it has been generated by MSVC 6.0. There are 3 parts 
visible: 1) getting source string length (first scasb); 2) getting destination string 
length (second scasb); 3) copying source string into the end of destination string 


(movsd/movsb pair). 
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Listing 3.55: strcat() 


lea edi, [src] 

or ecx, OFFFFFFFFh 
repne scasb 

not ecx 

sub edi, ecx 

mov esi, edi 

mov edi, [dst] 

mov edx, ecx 

or ecx, OFFFFFFFFh 
repne scasb 

mov ecx, edx 

dec edi 

shr ecx, 2 

rep movsd 

mov ecx, edx 

and ecx, 3 

rep movsb 


IDA script 


There is also a small IDA script for searching and folding such very frequently seen 
pieces of inline code: 


GitHub. 


3.15 C99 restrict 


Here is a reason why Fortran programs, in some cases, work faster than C/C++ ones. 


void fl (int* x, int* y, int* sum, int* product, int* sum product, int* 7 
S update me, size t s) 


1 
for (int i20; i<s; i++) 
1 
sum[il=x[i1+y[i1; 
product[il=x[i]*y[i]; 
update me[i]-i*123; // some dummy value 
sum product[i]ssum[i]*product[i]; 
hi 
}; 


That’s very simple example with one specific thing in it: the pointer to the update_me 
array could be a pointer to the sum array, product array, or even the sum product 
array—nothing forbids that, right? 


The compiler is fully aware of this, so it generates code with four stages in the loop 
body: 


e calculate next sum[i] 
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* calculate next product[i] 
* calculate next update me[i] 


* calculate next sum product[i]—on this stage, we need to load from memory 
the already calculated sum[i] and product[i] 


Is it possible to optimize the last stage? Since we have already calculated sum[i] 
and product[i] it is not necessary to load them again from memory. 


Yes, but compiler is not sure that nothing has been overwritten at the 3rd stage! 
This is called "pointer aliasing", a situation when the compiler cannot be sure that a 
memory to which a pointer is pointing hasn't been changed. 


restrict in the C99 standard [ISO/IEC 9899:1C3 (C C99 standard), (2007) 6.7.3/1]is a 
promise, given by programmer to the compiler that the function arguments marked 
by this keyword always points to different memory locations and never intersects. 


To be more precise and describe this formally, restrict shows that only this pointer 
is to be used to access an object, and no other pointer will be used for it. 


It can be even said the object will be accessed only via one single pointer, if it is 
marked as restrict. 


Let's add this keyword to each pointer argument: 


void f2 (int* restrict x, int* restrict y, int* restrict sum, int* restrict? 
S product, int* restrict sum product, 
int* restrict update me, size t s) 


{ 
for (int i=0; i<s; i++) 
{ 
sum[i]-x[i]-y[il; 
product [i]J=x[i]*y[i]; 
update me[i]-i*123; // some dummy value 
sum product[i]ssum[i]*product[i]; 
hi 
}; 


Let's see results: 


Listing 3.56: GCC x64: f1() 


f1: 
push r15 r14 r13 r12 rbp rdi rsi rbx 
mov r13, QWORD PTR 120[rsp] 
mov rbp, QWORD PTR 104[rsp] 
mov r12, QWORD PTR 112[rsp] 
test r13, r13 
je .L1 
add r13, 1 
xor ebx, ebx 
mov edi, 1 
xor r1ild, rlld 
jmp .L4 

.L6: 
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mov r11, rdi 
mov rdi, rax 
.L4: 
lea rax, 0[0+r11*4] 
lea r10, [recx+rax] 
lea r14, [rdx+rax] 
lea rsi, [r8+rax] 
add rax, r9 
mov r15d, DWORD PTR [r10] 
add r15d, DWORD PTR [r14] 
mov DWORD PTR [rsi], ri5d ; store to sum[] 
mov r10d, DWORD PTR [r10] 
imul r10d, DWORD PTR [r14] 
mov DWORD PTR [rax], r10d ; store to product[] 
mov DWORD PTR [r12+r11*4], ebx ; Store to update me[] 
add ebx, 123 
mov r10d, DWORD PTR [rsi] ; reload sum[i] 
add r10d, DWORD PTR [rax] ; reload product[i] 
lea rax, 1[rdi] 
cmp rax, r13 
mov DWORD PTR O[rbp+r11*4], r10d ; store to sum product[] 
jne .L6 
.L1: 
pop rbx rsi rdi rbp r12 r13 r14 r15 
ret 
Listing 3.57: GCC x64: f2() 
f2: 
push r13 r12 rbp rdi rsi rbx 
mov r13, QWORD PTR 104[rsp] 
mov rbp, QWORD PTR 88[rsp] 
mov r12, QWORD PTR 96[rsp] 
test r13, r13 
je .L7 
add r13, 1 
xor r10d, rl10d 
mov edi, 1 
xor eax, eax 
jmp .L10 
.L11: 
mov rax, rdi 
mov rdi, r11 
.L10: 
mov esi, DWORD PTR [rcx+rax*4] 
mov r11d, DWORD PTR [rdx+rax*4] 
mov DWORD PTR [rl2+rax*4], rl10d ; store to update mel] 
add rl10d, 123 
lea ebx, [rsi+r11] 
imul rlld, esi 
mov DWORD PTR [r8+rax*4], ebx ; Store to sum[] 
mov DWORD PTR [r9+rax*4], rlld ; store to product[] 
add rlld, ebx 
mov DWORD PTR O[rbp+rax*4], rlld ; store to sum product[] 
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lea r11, 1[rdi] 
cmp r11, r13 
jne .L11 
.L7: 
pop rbx rsi rdi rbp r12 r13 
ret 


The difference between the compiled f1() and f2() functions is as follows: in f1(), 
sum[i] and product[i] are reloaded in the middle of the loop, and in f2() there 
is no such thing, the already calculated values are used, since we "promised" the 
compiler that no one and nothing will change the values in sum[i] and product[i] 
during the execution of the loop's body, so it is "sure" that there is no need to load 
the value from memory again. 


Obviously, the second example works faster. 

But what if the pointers in the function's arguments intersect somehow? 
This is on the programmer's conscience, and the results will be incorrect. 
Let's go back to Fortran. 


Compilers of this programming language treats all pointers as such, so when it was 
not possible to set restrict in C, Fortran could generate faster code in these cases. 


How practical is it? 
In the cases when the function works with several big blocks in memory. 
There are a lot of such in linear algebra, for instance. 


Supercomputers/HPC!^ are very busy with linear algebra, so probably that is why, 
traditionally, Fortran is still used there [Eugene Loh, The Ideal HPC Programming 
Language, (2010)]. 


But when the number of iterations is not very big, certainly, the speed boost may 
not to be significant. 


3.16 Branchless abs() function 


Let's revisit an example we considered earlier 1.18.2 on page 177 and ask ourselves, 
is it possible to make a branchless version of the function in x86 code? 


int my abs (int i) 
1 
if (i«0) 
return -i; 
else 
return i; 


i 


And the answer is yes. 


14High-Performance Computing 
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3.16.1 Optimizing GCC 4.9.1 x64 
We could see it if we compile it using optimizing GCC 4.9: 


Listing 3.58: Optimizing GCC 4.9 x64 


my abs: 
mov edx, edi 
mov eax, edi 
sar edx, 31 


EDX is OxFFFFFFFF here if sign of input value is minus 

EDX is O if sign of input value is plus (including 0) 

the following two instructions have effect only if EDX is OxFFFFFFFF 
or idle if EDX is 0 


xor eax, edx 
sub eax, edx 
ret 


This is how it works: 
Arithmetically shift the input value right by 31. 


Arithmetical shift implies sign extension, so if the MSB is 1, all 32 bits are to be filled 
with 1, or with O if otherwise. 


In other words, the SAR REG, 31 instruction makes OxFFFFFFFF if the sign has been 
negative or O if positive. 


After the execution of SAR, we have this value in EDX. 


Then, if the value is OXFFFFFFFF (i.e., the sign is negative), the input value is inverted 
(because XOR REG, OxFFFFFFFF is effectively an inverse all bits operation). 


Then, again, if the value is OxFFFFFFFF (i.e., the sign is negative), 1 is added to the 
final result (because subtracting -1 from some value resulting in incrementing it). 


Inversion of all bits and incrementing is exactly how two's complement value is 
negated. 


We may observe that the last two instruction do something if the sign of the input 
value is negative. 


Otherwise (if the sign is positive) they do nothing at all, leaving the input value 
untouched. 


The algorithm is explained in [Henry S. Warren, Hacker's Delight, (2002)2-4]. 


It's hard to say, how GCC did it, deduced it by itself or found a suitable pattern among 
known ones? 


3.16.2 Optimizing GCC 4.9 ARM64 


GCC 4.9 for ARM64 generates mostly the same, just decides to use the full 64-bit 
registers. 


There are less instructions, because the input value can be shifted using a suffixed 
instruction ("asr") instead of using a separate instruction. 
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Listing 3.59: Optimizing GCC 4.9 ARM64 


my abs: 

; sign-extend input 32-bit value to X0 64-bit register: 
Sxtw x0, wO 
eor x1, x0, x0, asr 63 

; X1=X0"(X0>>63) (shift is arithmetical) 
sub x0, x1, x0, asr 63 


; XO=X1- (X0>>63)=X0" (X0>>63) - (X0>>63) 
; (all shifts are arithmetical) 
ret 


3.17 Variadic functions 


Functions like printf() and scanf() can have a variable number of arguments. How 
are these arguments accessed? 


3.17.1 Computing arithmetic mean 


Let's imagine that we want to calculate arithmetic mean, and for some weird reason 
we want to specify all the values as function arguments. 


But it's impossible to get the number of arguments in a variadic function in C/C++, 
so let's denote the value of -1 as a terminator. 


Using va arg macro 


There is the standard stdarg.h header file which define macros for dealing with such 
arguments. 


The printf() and scanf() functions use them as well. 


#include <stdio.h> 
#include <stdarg.h> 


int arith mean(int v, ...) 
1 
va list args; 
int sum=v, count=1, i; 
va start(args, v); 


while(1) 
1 
i-va arg(args, int); 
if (i==-1) // terminator 
break; 
sum=sum+i; 
count++; 


) 


va end(args); 
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return sum/count; 


H 
int main() 
1 
printf ("%d\n", arith mean (1, 2, 7, 10, 15, -1 /* terminator */)); 
$; 


The first argument has to be treated just like a normal argument. 
All other arguments are loaded using the va_arg macro and then summed. 


So what is inside? 


cdecl calling conventions 


Listing 3.60: Optimizing MSVC 6.0 


_v$ = 8 
 arith mean PROC NEAR 
mov eax, DWORD PTR v$[esp-4] ; load lst argument into sum 
push esi 
mov esi, 1 ; count=1 
lea edx, DWORD PTR v$[esp] ; address of the 1st argument 
$L838: 
mov ecx, DWORD PTR [edx+4] ; load next argument 
add edx, 4 ; shift pointer to the next 
argument 
cmp ecx, -1 ; is it -1? 
je SHORT $L856 ; exit if so 
add eax, ecx ; sum = sum + loaded argument 
inc esi ; count++ 
jmp SHORT $L838 
$L856: 
; calculate quotient 
cdq 
idiv esi 
pop esi 
ret 0 


 arith mean ENDP 


$SG851 DB 'Sd', OaH, 00H 
main PROC NEAR 

push -1 

push 15 

push 10 

push 7 

push 2 

push 1 

call  arith mean 

push eax 
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push OFFSET FLAT:$SG851 ; ‘%d' 


call | printf 
add esp, 32 
ret 0 

main  ENDP 


The arguments, as we may see, are passed to main() one-by-one. 
The first argument is pushed into the local stack as first. 
The terminating value (-1) is pushed last. 


The arith mean() function takes the value of the first argument and stores it in the 
sum Variable. 


Then, it sets the EDX register to the address of the second argument, takes the value 
from it, adds it to sum, and does this in an infinite loop, until -1 is found. 


When it's found, the sum is divided by the number of all values (excluding -1) and 
the quotient is returned. 


So, in other words, the function treats the stack fragment as an array of integer 
values of infinite length. 


Now we can understand why the cdecl calling convention forces us to push the first 
argument into the stack as last. 


Because otherwise, it would not be possible to find the first argument, or, for printf- 
like functions, it would not be possible to find the address of the format-string. 


Register-based calling conventions 


The observant reader may ask, what about calling conventions where the first few 
arguments are passed in registers? Let's see: 


Listing 3.61: Optimizing MSVC 2012 x64 


$SG3013 DB '*d', OaH, OOH 
v$ = 8 
arith mean PROC 
mov DWORD PTR [rsp+8], ecx ; lst argument 
mov QWORD PTR [rsp+16], rdx ; 2nd argument 
mov QWORD PTR [rsp+24], r8 ; 3rd argument 
mov eax, ecx ; sum = 1st argument 
lea rcx, QWORD PTR v$[rsp+8] ; pointer to the 2nd argument 
mov QWORD PTR [rsp+32], r9 ; 4th argument 
mov edx, DWORD PTR [rcx] ; load 2nd argument 
mov r8d, 1 ; count=1 
cmp edx, -1 ; 2nd argument is -1? 
je SHORT $LN8@arith_mean ; exit if so 
$LL3@arith_ mean: 
add eax, edx ; sum = sum + loaded argument 
mov edx, DWORD PTR [rcx+8] ; load next argument 
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lea rcx, QWORD PTR [rcx+8] ; shift pointer to point to the 
argument after next 

inc r8d ; count++ 

cmp edx, -1 ; is loaded argument -1? 

jne SHORT $LL3Qarith mean ; go to loop begin if its not 


$LN8@arith_ mean: 
; calculate quotient 


cdq 
idiv r8d 
ret 0 


arith mean ENDP 


main PROC 
sub rsp, 56 
mov edx, 2 
mov DWORD PTR [rsp+40], -1 
mov DWORD PTR [rsp+32], 15 
lea r9d, QWORD PTR [rdx+8] 
lea r8d, QWORD PTR [rdx+5] 
lea ecx, QWORD PTR [rdx-1] 
call arith mean 
lea rcx, OFFSET FLAT: $SG3013 
mov edx, eax 
call printf 
xor eax, eax 
add rsp, 56 
ret 0 

main ENDP 


We see that the first 4 arguments are passed in the registers and two more—in the 
stack. 


The arith mean() function first places these 4 arguments into the Shadow Space 
and then treats the Shadow Space and stack behind it as a single continuous array! 


What about GCC? Things are slightly clumsier here, because now the function is 
divided in two parts: the first part saves the registers into the “red zone”, processes 
that space, and the second part of the function processes the stack: 


Listing 3.62: Optimizing GCC 4.9.1 x64 


arith mean: 
lea rax, [rsp+8] 
; save 6 input registers in 
; red zone in the local stack 


mov QWORD PTR [rsp-40], rsi 
mov QWORD PTR [rsp-32], rdx 
mov QWORD PTR [rsp-16], r8 
mov QWORD PTR [rsp-24], rcx 
mov esi, 8 

mov QWORD PTR [rsp-64], rax 
lea rax, [rsp-48] 

mov QWORD PTR [rsp-8], r9 
mov DWORD PTR [rsp-72], 8 
lea rdx, [rsp+8] 
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.L7: 


.L8: 


.L5: 


.L4: 


LCL: 


main: 


mov r8d, 1 

mov QWORD PTR [rsp-56], rax 
jmp .L5 

; work out saved arguments 
lea rax, [rsp-48] 

mov ecx, esi 

add esi, 8 

add rcx, rax 

mov ecx, DWORD PTR [rcx] 
cmp ecx, -1 

je .L4 

add edi, ecx 

add r8d, 1 


; decide, which part we will work out now. 
; is current argument number less or equal 6? 


cmp esi, 47 

jbe .L7 ; no, process saved arguments then 
; work out arguments from stack 
mov rcx, rdx 

add rdx, 8 

mov ecx, DWORD PTR [rcx] 
cmp ecx, -1 

jne .L8 

mov eax, edi 

cdq 

idiv r8d 

ret 


.string "%d\n" 


sub rsp, 8 

mov edx, 7 

mov esi, 2 

mov edi, 1 

mov r9d, -1 

mov r8d, 15 

mov ecx, 10 

xor eax, eax 
call arith mean 
mov esi, OFFSET FLAT: .LC1 
mov edx, eax 

mov edi, 1 

xor eax, eax 

add rsp, 8 

jmp . printf chk 


By the way, a similar usage of the Shadow Space is also considered here: 6.1.8 on 
page 941. 
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Using pointer to the first function argument 


The example can be rewritten without va arg macro: 


#include <stdio.h> 


int arith_mean(int v, ...) 
{ 
int *i-&v; 
int sum-*i, count=1; 
i++; 
while(1) 
1 
if ((*i)==-1) // terminator 
break; 
sum=sum+(*i); 
count++; 
itt; 
} 
return sum/count; 
ur 
int main() 
1 
printf ("%d\n", arith mean (1, 2, 7, 10, 15, -1 /* terminator */)); 
// test: https://ww.wolframalpha.com/input/?i=mean(1,2,7,10,15) 
3 


In other words, if an argument set is array of words (32-bit or 64-bit), we just enu- 
merate array elements starting at first one. 


3.17.2 vprintf() function case 


Many programmers define their own logging functions which take a printf-like format 
string + a variable number of arguments. 


Another popular example is the die() function, which prints some message and exits. 


We need some way to pack input arguments of unknown number and pass them to 
the printf() function. But how? 


That’s why there are functions with “v” in name. 


One of them is vprintf(): it takes a format-string and a pointer to a variable of type 
va_list: 


#include <stdlib.h> 
#include <stdarg.h> 


void die (const char * fmt, ...) 


{ 


va list va; 
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va start (va, fmt); 


vprintf (fmt, va); 
exit(0); 
$; 


By closer examination, we can see that va_list is a pointer to an array. Let's com- 
pile: 


Listing 3.63: Optimizing MSVC 2010 


_fmt$ = 8 

_die PROC 
; load 1st argument (format-string) 
mov ecx, DWORD PTR fmt$[esp-4] 
; get pointer to the 2nd argument 
lea eax, DWORD PTR fmt$[esp] 
push eax ; pass a pointer 
push ecx 
call  vprintf 
add esp, 8 
push 0 
call exit 

$LN3@die: 
int 3 

_die ENDP 


We see that all our function does is just taking a pointer to the arguments and passing 
it to vprintf(), and that function is treating it like an infinite array of arguments! 


Listing 3.64: Optimizing MSVC 2012 x64 


fmt$ - 48 
die PROC 
; save first 4 arguments in Shadow Space 
mov QWORD PTR [rsp+8], rcx 
mov QWORD PTR [rsp+16], rdx 
mov QWORD PTR [rsp+24], r8 
mov QWORD PTR [rsp+32], r9 
sub rsp, 40 
lea rdx, QWORD PTR fmt$[rsp+8] ; pass pointer to the 1st argument 
; RCX here is still points to the 1st argument (format-string) of 
die() 


; so vprintf() will take it right from RCX 
call vprintf 


xor ecx, ecx 
call exit 
int 3 

die ENDP 
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3.17.3 Pin case 


It's interesting to note how some functions from Pin DBI!? framework takes number 
of arguments: 


INS InsertPredicatedCall( 
ins, IPOINT BEFORE, (AFUNPTR)RecordMemRead, 
IARG INST PTR, 
IARG MEMORYOP EA, memOp, 
IARG END); 


( pinatrace.cpp ) 
And this is how INS InsertPredicatedCall() function is declared: 


extern VOID INS InsertPredicatedCall(INS ins, IPOINT ipoint, AFUNPTR funptr 
PETS 


(pin client.PH) 


Hence, constants with names starting with IARG are some kinds of arguments 

to the function, which are handled inside of INS InsertPredicatedCall(). You 
can pass as many arguments, as you need. Some commands has additional ar- 
gument(s), some are not. Full list of arguments: https://software.intel.com/ 
sites/landingpage/pintool/docs/58423/Pin/html/group INST  ARGS.html. And 
it has to be a way to detect an end of arguments list, so the list must be terminated 
with IARG END constant, without which, the function will (try to) handle random noise 

in the local stack, treating it as additional arguments. 


Also, in [Brian W. Kernighan, Rob Pike, Practice of Programming, (1999)] we can find 
a nice example of C/C++ routines very similar to pack/unpack!? in Python. 


3.17.4 Format string exploit 


It’s a popular mistake, to write printf(string) instead of puts(string) orprintf("%s", 
string). If the attacker can put his/her own text into string, he/she can crash pro- 
cess, or get insight into variables in the local stack. 


Take a look at this: 


#include <stdio.h> 


int main() 

{ 
char *sl="hello"; 
char *s2="world"; 
char buf[128]; 


// do something mundane here 
strcpy (buf, s1); 
strcpy (buf, " "); 


15Dynamic Binary Instrumentation 
l6https://docs.python.org/3/library/struct.html 
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strcpy (buf, s2); 


printf ("%s"); 
ur 


Please note, that printf() has no additional arguments besides single format string. 


Now let's imagine, that was the attacker who put %s string into the last printf() 
first arguments. | compile this example using GCC 5.4.0 on x86 Ubuntu, and the 
resulting executable prints "world" string if it gets executed! 


If | turn optimization on, printf() outputs some garbage, though— probably, strcpy() 
calls has been optimized and/or local variables as well. Also, result will be different 
for x64 code, different compiler, OS, etc. 


Now, let's say, attacker could pass the following string to printf() call: %x %x %x 
%x %x. In may case, output is: “80485c6 b7751b48 1 0 80485c0” (these are just 
values from local stack). You see, there are 1 and 0 values, and some pointers (first is 
probably pointer to "world" string). So if the attacker passes *ss %s %s %s %s string, 
the process will crash, because printf() treats 1 and/or 0 as pointer to string, tries 
to read characters from there and fails. 


Even worse, there could be sprintf (buf, string) in code, where buf is a buffer 
in the local stack with size of 1024 bytes or so, attacker can craft string in such 
a way that buf will be overflown, maybe even in a way that would lead to code 
execution. 


Many popular and well-known software was (or even still) vulnerable: 


QuakeWorld went up, got to around 4000 users, then the master 
server exploded. 

Disrupter and cohorts are working on more robust code now. 

If anyone did it on purpose, how about letting us know... (It wasn't 
all the people that tried 96s as a name) 


(John Carmack's .plan file, 17-Dec-1996?’ ) 
Nowadays, almost all decent compilers warn about this. 


Another problem is the lesser known %n printf() argument: whenever printf() 
reaches it in a format string, it writes the number of characters printed so far into 
the corresponding argument: stackoverflow.com. Thus, an attacker could zap local 
variables by passing many %n commands in format string. 


3.18 Strings trimming 


A very common string processing task is to remove some characters at the start 
and/or at the end. 


V https://github.com/ESWAT/ john- carmack- plan- archive/blob/33ae52fdba46aa0dlabfed6fc7598233748541c0/ 
by day/johnc plan 19961217.txt 
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In this example, we are going to work with a function which removes all newline 


characters (CR19/LF1?) from the end of the input string: 


#include <stdio.h> 
#include <string.h> 


char* str_trim (char *s) 


{ 
char C; 
size t str len; 
// work as long as Nr or An is at the end of string 
// stop if some other character there or its an empty string 
// (at start or due to our operation) 
for (str lensstrlen(s); str len»0 && (c=s[str_len-1]); str len--) 
1 
if (c=='\r' || c=='\n') 
s[str_len-1]=0; 
else 
break; 
y; 
return s; 
}; 
int main() 
{ 
// test 
// strdup() is used to copy text string into data segment, 
// because it will crash on Linux otherwise, 
// where text strings are allocated in constant data segment, 
// and not modifiable. 
printf ("[%s]\n", str trim (strdup(""))); 
printf ("[%s]\n", str trim (strdup("\n"))); 
printf ("([%s]\n", str trim (strdup("\r"))); 
printf ("([%s]\n", str trim (strdup("\n\r"))); 
printf ("[%s]\n", str_trim (strdup("\r\n"))); 
printf ("[%s]\n", str trim (strdup("test1l\r\n"))); 
printf ("[%s]\n", str_trim (strdup("test2\n\r"))); 
printf ("[%s]\n", str trim (strdup("test3\n\r\n\r"))); 
printf ("[%s]\n", str trim (strdup("test4\n"))); 
printf ("[%s]\n", str trim (strdup("test5\r"))); 
printf ("[%s]\n", str trim (strdup("test6\r\r\r"))); 
}; 


The input argument is always returned on exit, this is convenient when you want to 


chain string processing functions, like it has done here in the main() function. 


The second part of for() (str len20 && (c=s[str_len-1])) is the so called "short- 
circuit" in C/C++ and is very convenient [Dennis Yurichev, C/C++ programming lan- 


18Carriage Return (13 or ‘\r’ in C/C++) 
19| ine Feed (10 or ^n' in C/C++) 
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guage notes1.3.8]. 

The C/C++ compilers guarantee an evaluation sequence from left to right. 

So if the first clause is false after evaluation, the second one is never to be evaluated. 
3.18.1 x64: Optimizing MSVC 2013 


Listing 3.65: Optimizing MSVC 2013 x64 


s$ = 8 
str trim PROC 


; RCX is the first function argument and it always holds pointer to the 
string 
mov rdx, rcx 
; this is strlen() function inlined right here: 
; set RAX to OxFFFFFFFFFFFFFFFF (-1) 


or rax, -1 
$LL14gstr trim: 
inc rax 
cmp BYTE PTR [rcx+rax], 0 
jne SHORT $LL14@str_trim 
; is the input string length zero? exit then: 
test rax, rax 
je SHORT $LN15@str_trim 
; RAX holds string length 
dec rcx 
; RCX = s-1 
mov r8d, 1 
add rcx, rax 
; RCX = s-1+strlen(s), i.e., this is the address of the last character in the 
string 
sub r8, rdx 
; R8 = 1-s 


$LL6Gstr trim: 
; load the last character of the string: 
; jump, if its code is 13 or 10: 

movzx eax, BYTE PTR [rcx] 


cmp al, 13 
je SHORT $LN2Gstr trim 
cmp al, 10 
jne SHORT $LN15Gstr trim 


$LN2Gstr trim: 
; the last character has a 13 or 10 code 
; write zero at this place: 
mov BYTE PTR [rcx], 0 
; decrement address of the last character, 
; so it will point to the character before the one which has just been 


erased: 
dec rcx 
lea rax, QWORD PTR [r8+rcx] 


; RAX = 1 - s + address of the current last character 
; thus we can determine if we reached the first character and we need to 
stop, if it is so 
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test rax, rax 

jne SHORT $LL6Gstr trim 
$LN15Gstr trim: 

mov rax, rdx 

ret 0 


str trim ENDP 


First, MSVC inlined the strlen() function code, because it concluded this is to be 
faster than the usual strlen() work + the cost of calling it and returning from it. 
This is called inlining: 3.14 on page 634. 


The first instruction of the inlined strlen() is 
OR RAX, OxFFFFFFFFFFFFFFFF. 


MSVC often uses OR instead of MOV RAX, OxFFFFFFFFFFFFFFFF, because resulting 
opcode is shorter. 


And of course, it is equivalent: all bits are set, and a number with all bits set is -1 in 
two's complement arithmetic. 


Why would the -1 number be used in strlen(), one might ask. Due to optimizations, 
of course. Here is the code that MSVC generated: 


Listing 3.66: Inlined strlen() by MSVC 2013 x64 


; RCX = pointer to the input string 
; RAX = current string length 
or rax, -1 
label: 
inc rax 
cmp BYTE PTR [rcx+rax], 0 
jne SHORT label 


; RAX = string length 


Try to write shorter if you want to initialize the counter at 0! OK, let' try: 


Listing 3.67: Our version of strlen() 


; RCX = pointer to the input string 
; RAX = current string length 
xor rax, rax 
label: 
cmp byte ptr [rcx+rax], 0 
jz exit 
inc rax 
jmp label 
exit: 


; RAX = string length 


We failed. We have to use additional JMP instruction! 


So what the MSVC 2013 compiler did is to move the INC instruction to the place 
before the actual character loading. 


If the first character is O, that's OK, RAX is O at this moment, so the resulting string 
length is O. 
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The rest in this function seems easy to understand. 


3.18.2 x64: Non-optimizing GCC 4.9.1 


str trim: 


; for() 


.L3: 


; for() 
.L4: 


; return 


push rbp 

mov rbp, rsp 

sub rsp, 32 

mov QWORD PTR [rbp-24], rdi 
first part begins here 

mov rax, QWORD PTR [rbp-24] 
mov rdi, rax 

call strlen 

mov QWORD PTR [rbp-8], rax 
first part ends here 

jmp .L2 

body begins here 

cmp BYTE PTR [rbp-9], 13 
je .L3 

cmp BYTE PTR [rbp-9], 10 
jne .L4 

mov rax, QWORD PTR [rbp-8] 
lea rdx, [rax-1] 

mov rax, QWORD PTR [rbp-24] 
add rax, rdx 

mov BYTE PTR [rax], 0 


body ends here 

third part begins here 

sub QWORD PTR [rbp-8], 1 
third part ends here 


second part begins here 


cmp QWORD PTR [rbp-8], 0 
je .L4 
second clause, and load "c" 
mov rax, QWORD PTR [rbp-8] 
lea rdx, [rax-1] 
mov rax, QWORD PTR [rbp-24] 
add rax, rdx 
movzx eax, BYTE PTR [rax] 
mov BYTE PTR [rbp-9], al 
cmp BYTE PTR [rbp-9], 0 
jne .L5 
second part ends here 

"ngu 
mov rax, QWORD PTR [rbp-24] 
leave 

ret 


str len 
c=='\r'? 
c=='\n'? 
str_len 


EDX=str_len-1 


S 
; RAX=s+str_len-1 


s[str_len-1]=0 


str len-- 


str len--0? 


; exit then 


; RAXestr len 

; RDXestr len-1 

; RAX=s 

; RAX=s+str_len-1 
; AL=s[str_len-1] 


store loaded char into 
is it zero? 


; yes? exit then 


"ch 


Comments are added by the author of the book. 
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After the execution of strlen(), the control is passed to the L2 label, and there two 
clauses are checked, one after another. 


The second will never be checked, if the first one (str_len==0) is false (this is “short- 
circuit"). 


Now let's see this function in short form: 
* First for() part (call to strlen()) 
* goto L2 
* L5: for() body. goto exit, if needed 


for() third part (decrement of str len) 


* [2: for() second part: check first clause, then second. goto loop body begin or 
exit. 


e L4: // exit 


* returns 


3.18.3 x64: Optimizing GCC 4.9.1 


str trim: 
push rbx 
mov rbx, rdi 
; RBX will always be "s" 
call strlen 
; check for str len--0 and exit if its so 
test rax, rax 
je .L9 
lea rdx, [rax-1] 


; RDX will always contain str len-1 value, not str len 
; so RDX is more like buffer index variable 


lea rsi, [rbx+rdx] ; RSI=s+str_len-1 

movzx ecx, BYTE PTR [rsi] ; load character 

test cl, cl 

je .L9 ; exit if its zero 

cmp cl, 10 

je .L4 

cmp cl, 13 ; exit if its not 'An' and not '\r' 
jne .L9 


.L4: 
; this is weird instruction. we need RSI=s-1 here. 
; its possible to get it by MOV RSI, EBX / DEC RSI 
; but this is two instructions instead of one 

sub rsi, rax 
; RSI = s«str len-1-str len = 
; main loop begin 
.L12: 


s-1 


test rdx, rdx 

; store zero at address s-1+str_len-1+1 = s-1+str_len = 
mov BYTE PTR [rsi+l+rdx], O 

; check for str len-1--0. exit if so. 


s+str_len-1 
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je .L9 

sub rdx, 1 ; equivalent to str len-- 
; load next character at address s+str len-1 

movzx ecx, BYTE PTR [rbx+rdx] 


test cl, cl ; is it zero? exit then 
je .L9 
cmp cl, 10 ; is it 'An'? 
je .L12 
cmp cl, 13 ; Xs xt "Xp'? 
je .L12 

.L9: 

; return "s" 
mov rax, rbx 
pop rbx 
ret 


Now this is more complex. 


The code before the loop's body start is executed only once, but it has the CR/LF 
characters check too! What is this code duplication for? 


The common way to implement the main loop is probably this: 
* (loop start) check for CR/LF characters, make decisions 
* store zero character 
But GCC has decided to reverse these two steps. 
Of course, store zero character cannot be first step, so another check is needed: 
* workout first character. match it to CR/LF, exit if character is not CR/LF 
* (loop begin) store zero character 
* check for CR/LF characters, make decisions 
Now the main loop is very short, which is good for latest CPUs. 


The code doesn't use the str len variable, but str len-1. So this is more like an index 
in a buffer. 


Apparently, GCC notices that the str len-1 statement is used twice. 


So it's better to allocate a variable which always holds a value that's smaller than 
the current string length by one, and decrement it (this is the same effect as decre- 
menting the str len variable). 


3.18.4 ARM64: Non-optimizing GCC (Linaro) 4.9 
This implementation is straightforward: 


Listing 3.68: Non-optimizing GCC (Linaro) 4.9 


str trim: 
stp x29, x30, [sp, -48]! 
add x29, sp, 0 
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str x0, [x29,24] ; copy input argument into local stack 
ldr x0, [x29,24] ; s 
bl strlen 
str x0, [x29,40] ; str len variable in local stack 
b .L2 
; main loop begin 
.L5: 
ldrb w0, [x29,39] 
; WO=cC 
cmp w0, 13 ; is it 'Nr'? 
beq .L3 
ldrb w0, [x29,39] 
; WO=cC 
cmp w0, 10 ; 1s Xt "An"? 
bne .L4 ; goto exit if it is not 
.L3: 
ldr x0, [x29,40] 
; X0-str len 
sub x0, x0, #1 
; X0-str len-1 
ldr x1, [x29,24] 
; Xl=s 
add x0, x1, x0 
; X0-s«str len-1 
strb wzr, [x0] ; write byte at s«str len-1 


decrement str len: 
ldr x0, [x29,40] 


; X0-str len 
sub x0, x0, #1 
; X0-str len-1 
str x0, [x29,40] 
; save X0 (or str len-1) to local stack 
.L2: 


ldr x0, [x29,40] 
; Str len--0? 


cmp x0, xzr 
; goto exit then 

beq .L4 

ldr x0, [x29,40] 
; X0-str len 

sub x0, x0, #1 
; X0-str len-1 

ldr x1, [x29,24] 
; Xl=s 

add x0, x1, x0 


; X0-s«str len-1 
load byte at address s+str_len-1 to WO 
ldrb w0, [x0] 
strb w0, [x29,39] ; store loaded byte to "c" 
ldrb w0, [x29,39] ; reload it 
; is it zero byte? 
cmp w0, wzr 
; goto exit, if its zero or to L5 if its not 
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bne .L5 
.L4: 
; return s 
ldr x0, [x29,24] 
ldp x29, x30, [sp], 48 
ret 


3.18.5 ARM64: Optimizing GCC (Linaro) 4.9 


This is a more advanced optimization. 


The first character is loaded at the beginning, and compared against 10 (the LF 
character). 


Characters are also loaded in the main loop, for the characters after first one. 


This is somewhat similar to the 3.18.3 on page 663 example. 


Listing 3.69: Optimizing GCC (Linaro) 4.9 


str trim: 
stp x29, x30, [sp, -32]! 
add x29, sp, 0 
str x19, [sp,16] 
mov x19, x0 
; X19 will always hold value of "s" 
bl strlen 
; X0-str len 
cbz x0, .L9 ; goto L9 (exit) if str len--0 
sub x1, x0, #1 
; X1=X0-1=str_len-1 
add x3, x19, xl 
; X3=X19+X1=s+str_len-1 
ldrb w2, [x19,x1] ; load byte at address X19+X1=s+str len-1 
; W2=Loaded character 
cbz w2, .L9 ; is it zero? jump to exit then 
cmp w2, 10 ; is it '\n'? 
bne .L15 
.L12: 
; main loop body. loaded character is always 10 or 13 at this moment! 
sub x2, x1, x0 
; X2-X1-X0-str len-1-str len--1 
add x2, x3, x2 
; X2=X3+X2=s+str_len-1+(-1)=s+str_len-2 
strb wzr, [x2,1] ; Store zero byte at address 
s+str_len-2+1=s+str_len-1 
cbz x1, .L9 ; Str len-1--0? goto exit, if so 
sub x1, x1, #1 ; str len-- 
ldrb w2, [x19,x1] ; load next character at address 
X19+X1=s+str_len-1 
cmp w2, 10 ; is it '\n'? 
cbz w2, .L9 ; jump to exit, if its zero 
beq .L12 ; jump to begin loop, if its 'An' 
.L15: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


667 


cmp w2, 13 i is it '\r"? 

beq . L12 ; yes, jump to the loop body begin 
.L9: 
; return "s" 

mov x0, x19 

ldr x19, [sp,16] 

ldp x29, x30, [sp], 32 

ret 


3.18.6 ARM: Optimizing Keil 6/2013 (ARM mode) 


And again, the compiler took advantage of ARM mode's conditional instructions, so 
the code is much more compact. 


Listing 3.70: Optimizing Keil 6/2013 (ARM mode) 


str trim PROC 


PUSH {r4, lr} 
; RO=s 
MOV r4,r0 
; R4=s 
BL strlen ; Strlen() takes "s" value from RO 
; RO-str len 
MOV r3,*0 
; R3 will always hold 0 
[L0.16| 
CMP r0,#0 ; str_len==0? 
ADDNE r2,r4,r0 ; (if str len!z0) R2=R4+R0=s+str_len 


LDRBNE r1,[r2, 4-1] ; (if str len!z0) Rl=load byte at address 
R2-1=s+str_len-1 


CMPNE r1,#0 ; (if str_len!=0) compare loaded byte against 0 

BEQ [L0.56| ; jump to exit if str len-z0 or loaded byte is 
0 

CMP r1,#0xd ; is loaded byte '\r'? 


CMPNE r1,#0xa ; 
(if loaded byte is not '\r' ) is loaded byte '\r'? 

SUBEQ r0,r0,#1 
(if loaded byte is 'Wr' or. 'Nn' ) RO-- or str len-- 

STRBEQ r3,[r2,#-1] ; (if loaded byte is '\r' or '\n') store R3 
(zero) at address R2-1= s+str_ len-1 


BEQ [L0.16| 
jump to loop begin if loaded byte was 'Nr' or ‘\n' 
[L0.56| 
; return "s" 
MOV ro,r4 
POP {r4,pc} 
ENDP 


3.18.7 ARM: Optimizing Keil 6/2013 (Thumb mode) 


There are less conditional instructions in Thumb mode, so the code is simpler. 
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But there are is really weird thing with the 0x20 and Ox1F offsets (lines 22 and 23). 
Why did the Keil compiler do so? Honestly, it's hard to say. 


It has to be a quirk of Keil's optimization process. Nevertheless, the code works 
correctly. 


Listing 3.71: Optimizing Keil 6/2013 (Thumb mode) 


str trim PROC 


PUSH {r4,lr} 
MOVS r4,r0 
; R4=s 
BL strlen ; Strlen() takes "s" value from RO 
; RO-str len 
MOVS r3,*0 
; R3 will always hold 0 
B [L0.24| 
[L0.12| 
CMP r1,#0xd ; is loaded byte '\r'? 
BEQ [L0.20| 
CMP r1,#0xa ; is loaded byte '\n'? 
BNE [L0.38| ; jump to exit, if no 
[L0.20| 
SUBS r0,r0,71 ; RO-- or str len-- 
STRB r3,[r2,£0x1f] ; store 0 at address 
R2+0x1F=s+str_len-0x20+0x1F=s+str_len-1 
[L0.24| 
CMP r0,#0 ; str_len==0? 
BEQ [L0.38| ; yes? jump to exit 
ADDS r2,r4,r0 ; R2=R4+R0=s+str_len 
SUBS r2,r2,*0x20 ; R2=R2-0x20=s+str_len-0x20 
LDRB rl,[r2,£0x1f] ; load byte at address 
R2+0x1F=s+str_len-0x20+0x1F=s+str_len-1 to R1 
CMP r1,#0 ; is loaded byte 0? 
BNE [L0.12| ; jump to loop begin, if its not 0 
[L0.38| 
; return "s" 
MOVS ro,r4 
POP {r4,pc} 
ENDP 


3.18.8 MIPS 


Listing 3.72: Optimizing GCC 4.4.5 (IDA) 


str_trim: 
; IDA is not aware of local variable names, we gave them manually: 
saved GP = -0x10 


saved SO = -8 

saved RA 2.4 
lui $gp, (  gnu local gp >> 16) 
addiu $sp, -0x20 
i $gp, ( gnu local gp € OxFFFF) 
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SW $ra, 0x20+saved_RA($sp) 
SW $s0, Ox20+saved SO($sp) 
SW $gp, Ox20+saved GP($sp) 
; call strlen(). input string address is still in $a0, strlen() will take it 
from there: 
lw $t9, (strlen € OxFFFF) ($gp) 
or $at, $zero ; load delay slot, NOP 
jalr $t9 
; input string address is still in $a0, put it to $s0: 
move $s0, $a0 ; branch delay slot 


result of strlen() (i.e, length of string) is in $v0 now 
; jump to exit if $v0--0 (i.e., if length of string is 0): 
beqz $v0, exit 
or $at, $zero ; branch delay slot, NOP 
addiu $al, $v0, -1 
; $al = $v0-1 = str len-1 
addu $al, $s0, $al 
; $al = input string address + $al = s+strlen-1 
; load byte at address $al: 
lb $a0, 0($a1) 
or $at, $zero ; load delay slot, NOP 
loaded byte is zero? jump to exit if its so: 
beqz $a0, exit 
or $at, $zero ; branch delay slot, NOP 
addiu $v1, $v0, -2 
; $v1 = str len-2 
addu $v1, $s0, $vl 
; $v1 = $s0+$vl1 = s+str_len-2 


li $a2, OxD 
; Skip loop body: 

b loc 6C 

li $a3, OxA ; branch delay slot 
loc 5C: 
; load next byte from memory to $a0: 

lb $a0, O($v1) 

move $al, $v1 


; $fal=s+str_len-2 

; jump to exit if loaded byte is zero: 
beqz $a0, exit 

; decrement str len: 


addiu $v1, -1 ; branch delay slot 
loc 6C: 
; at this moment, $a0-loaded byte, $a2=0xD (CR symbol) and $a3=0xA (LF 
symbol) 
; loaded byte is CR? jump to loc 7C then: 
beq $a0, $a2, loc 7C 
addiu $v0, -1 ; branch delay slot 
; loaded byte is LF? jump to exit if its not LF: 
bne $a0, $a3, exit 
or $at, $zero ; branch delay slot, NOP 
loc 7C: 


; loaded byte is CR at this moment 
; jump to loc 5c (loop body begin) if str len (in $v0) is not zero: 
bnez $v@, loc 5C 
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; simultaneously, store zero at that place in memory: 


sb $zero, 0($al) ; branch delay slot 
; "exit" Label was named by me manually: 
exit: 

lw $ra, 0x20+saved_RA($sp) 

move $vO0, $s0 

lw $s0, Ox20+saved SO($sp) 

jr $ra 

addiu  $sp, 0x20 ; branch delay slot 


Registers prefixed with S- are also called "saved temporaries”, so $50 value is saved 
in the local stack and restored upon finish. 


3.19 toupper() function 


Another very popular function transforms a symbol from lower case to upper case, 
if needed: 


char toupper (char c) 


if(c>='a' && c<='z') 
return c-'a'+'A'; 
else 
return C; 


The 'a'+'A' expression is left in the source code for better readability, it will be 
optimized by compiler, of course 2°. 


The ASCII code of "a" is 97 (or 0x61), and 65 (or 0x41) for "A". 
The difference (or distance) between them in the ASCII table is 32 (or 0x20). 


For better understanding, the reader may take a look at the 7-bit standard ASCII 
table: 


Figure 3.3: 7-bit ASCII table in Emacs 


20However, to be meticulous, there still could be compilers which can't optimize such expressions and 
will leave them right in the code 
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3.19.1 x64 


Two comparison operations 


Non-optimizing MSVC is straightforward: the code checks if the input symbol is in 


, 


[97..122] range (or in ['a'..'z'] range) and subtracts 32 if it's true. 


There are also some minor compiler artifact: 


Listing 3.73: Non-optimizing MSVC 2013 (x64) 


c$ = 8 
toupper PROC 

mov BYTE PTR [rsp+8], cl 

movsx eax, BYTE PTR c$[rsp] 

cmp eax, 97 

jl SHORT $LN2@toupper 

movsx eax, BYTE PTR c$[rsp] 

cmp eax, 122 

jg SHORT $LN2@toupper 

movsx eax, BYTE PTR c$[rsp] 

sub eax, 32 

jmp SHORT $LN3@toupper 

jmp SHORT $LN1@toupper ; compiler artifact 
$LN2@toupper: 

movzx eax, BYTE PTR c$[rsp] ; unnecessary casting 
$LN1Gtoupper: 
$LN3@toupper: ; compiler artifact 

ret 0 


toupper ENDP 


It’s important to notice that the input byte is loaded into a 64-bit local stack slot at 


line 3. 


All the remaining bits ([8..63]) are untouched, i.e., contain some random noise (you'll 


see it in debugger). 


All instructions operate only on byte-level, so it's fine. 


The last MOVZX instruction at line 15 takes the byte from the local stack slot and 
zero-extends it to a int 32-bit data type. 


Non-optimizing GCC does mostly the same: 


Listing 3.74: Non-optimizing GCC 4.9 (x64) 


toupper: 

push rbp 

mov rbp, rsp 

mov eax, edi 

mov BYTE PTR [rbp-4], al 
cmp BYTE PTR [rbp-4], 96 
jte .L2 

cmp BYTE PTR [rbp-4], 122 
jg .L2 

movzx eax, BYTE PTR [rbp-4] 
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sub eax, 32 

jmp .L3 
.L2: 

movzx eax, BYTE PTR [rbp-4] 
.L3: 

pop rbp 

ret 


One comparison operation 
Optimizing MSVC does a better job, it generates only one comparison operation: 


Listing 3.75: Optimizing MSVC 2013 (x64) 


toupper PROC 
lea eax, DWORD PTR [rcx-97] 
cmp al, 25 
ja SHORT $LN2@toupper 
movsx eax, cl 
sub eax, 32 
ret 0 
$LN2@toupper: 
movzx eax, cl 
ret 0 
toupper ENDP 


It was explained earlier how to replace the two comparison operations with a single 
one: 3.13.2 on page 632. 


We will now rewrite this in C/C++: 


int tmp=c-97; 


if (tmp>25) 
return c; 
else 


return c-32; 


The tmp variable must be signed. 


This makes two subtraction operations in case of a transformation plus one compar- 
ison. 


In contrast the original algorithm uses two comparison operations plus one subtract- 
ing. 


Optimizing GCC is even better, it gets rid of the jumps (which is good: 2.4.1 on 
page 575) by using the CMOVcc instruction: 


Listing 3.76: Optimizing GCC 4.9 (x64) 


1 | toupper: 
2 lea edx, [rdi-97] ; 0x61 
3 lea eax, [rdi-32] ; 0x20 
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cmp dl, 25 
cmova eax, edi 
ret 


At line 3 the code prepares the subtracted value in advance, as if the conversion will 
always happen. 


At line 5 the subtracted value in EAX is replaced by the untouched input value if a 
conversion is not needed. And then this value (of course incorrect) is dropped. 


Advance subtracting is a price the compiler pays for the absence of conditional 
jumps. 


3.19.2 ARM 


Optimizing Keil for ARM mode also generates only one comparison: 


Listing 3.77: Optimizing Keil 6/2013 (ARM mode) 


toupper PROC 
SUB r1,r0,#0x61 
CMP r1,#0x19 
SUBLS r0,rQ,#0x20 
ANDLS r0, r0,#0xf f 
BX lr 


The SUBLS and ANDLS instructions are executed only if the value in R1 is less than 
0x19 (or equal). They also do the actual conversion. 


Optimizing Keil for Thumb mode generates only one comparison operation as well: 


Listing 3.78: Optimizing Keil 6/2013 (Thumb mode) 


toupper PROC 


MOVS r1,r0 

SUBS r1,r1,#0x61 

CMP r1,#0x19 

BHI [L0.14| 

SUBS r0, r0,#0x20 

LSLS r0,r0,#24 

LSRS r0,r0,#24 
[L0.14| 

BX lr 

ENDP 


The last two LSLS and LSRS instructions work like AND reg, OxFF: they are equiva- 
lent to the C/C++-expression (i << 24) >> 24. 


Seems like that Keil for Thumb mode deduced that two 2-byte instructions are shorter 
than the code that loads the OxFF constant into a register plus an AND instruction. 
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GCC for ARM64 


Listing 3.79: Non-optimizing GCC 4.9 (ARM64) 


toupper: 
sub sp, sp, #16 
strb w0, [sp,15] 
ldrb w0, [sp,15] 
cmp w0, 96 


bls L2 
ldrb w0, [sp,15] 
cmp w0, 122 
bhi .L2 
ldrb w0, [sp,15] 
sub w0, w0, #32 
uxtb w0, wO 
b .L3 
.L2: 
ldrb w0, [sp,15] 
.L3: 
add sp, sp, 16 
ret 
Listing 3.80: Optimizing GCC 4.9 (ARM64) 
toupper: 
uxtb w0, wO 
sub wl, w0, #97 
uxtb wl, wl 
cmp wl, 25 
bhi .L2 
sub w0, w0, #32 
uxtb w0, wO 
.L2: 


3.19.3 Using bit operations 


Given the fact that 5th bit (counting from Oth) is always present after the check, 
subtracting is merely clearing this sole bit, but the very same effect can be achieved 
with ANDing. 


Even simpler, with XOR-ing: 


char toupper (char c) 


1 
if(c>='a' && c<='z') 
return c^0x20; 
else 
return C; 
} 
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(3.76 on page 672): 


Listing 3.81: Optimizing GCC 5.4 (x86) 


toupper: 
mov edx, DWORD PTR [esp+4] 
lea ecx, [edx-97] 
mov eax, edx 
xor eax, 32 
cmp cl, 25 
cmova eax, edx 
ret 


...but XOR is used instead of SUB. 
Flipping 5th bit is just moving a cursor in ASCII table up and down by two rows. 


Some people say that lowercase/uppercase letters has been placed in the ASCII table 
in such a way deliberately, because: 


Very old keyboards used to do Shift just by toggling the 32 or 16 
bit, depending on the key; this is why the relationship between small 
and capital letters in ASCII is so regular, and the relationship between 
numbers and symbols, and some pairs of symbols, is sort of regular if 
you squint at it. 


(Eric S. Raymond, http: //www.catb.org/esr/faqs/things-every-hacker-once- knew/ 
) 


Therefore, we can write this piece of code, which just flips the case of letters: 


#include <stdio.h> 
char flip (char c) 
{ 
if((c>='a' && c<='z') || (c>='A' 68 c<='Z')) 
return c^0x20; 
else 
return c; 
} 
int main() 
{ 
// will produce "hELLO, WORLD!" 
for (char *s="Hello, world!"; *s; s++) 
printf ("%c", flip(*s)); 
i 
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3.19.4 Summary 


All these compiler optimizations are very popular nowadays and a practicing reverse 
engineer usually sees such code patterns often. 


3.20 Obfuscation 


The obfuscation is an attempt to hide the code (or its meaning) from reverse engi- 
neers. 


3.20.1 Text strings 


As we know from (5.4 on page 895), text strings may be really helpful. 


Programmers who are aware of this try to hide them, making it impossible to find 
the string in IDA or any hex editor. 


Here is the simplest method. 


This is how the string can be constructed: 


mov byte ptr [ebx], 'h' 
mov byte ptr [ebx+1], 'e' 
mov byte ptr [ebx+2], 'l' 
mov byte ptr [ebx+3], 'l' 
mov byte ptr [ebx+4], 'o' 
mov byte ptr [ebx+5], ' ' 
mov byte ptr [ebx+6], 'w' 
mov byte ptr [ebx+7], 'o' 
mov byte ptr [ebx+8], 'r' 
mov byte ptr [ebx+9], 'l' 
mov byte ptr [ebx+10], 'd' 


The string can also be compared with another one like this: 


mov ebx, offset username 
cmp byte ptr [ebx], 'j' 
jnz fail 

cmp byte ptr [ebx+1], 'o' 
jnz fail 

cmp byte ptr [ebx+2], 'h' 
jnz fail 

cmp byte ptr [ebx+3], 'n' 
jnz fail 

jz it is john 


In both cases, it is impossible to find these strings straightforwardly in a hex editor. 


By the way, this is a way to work with the strings when it is impossible to allocate 
space for them in the data segment, for example in a PIC?! or in shellcode. 


Another method is to use sprintf() for the construction: 


21position Independent Code 
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sprintf(buf, "*s*c*s*cess", "hel",'l',"o w",'o',"rld"); 


The code looks weird, but as a simple anti-reversing measure, it may be helpful. 


Text strings may also be present in encrypted form, then every string usage is to be 
preceded by a string decrypting routine. For example: 8.8.2 on page 1065. 


3.20.2 Executable code 
Inserting garbage 


Executable code obfuscation implies inserting random garbage code between real 
one, which executes but does nothing useful. 


A simple example: 


Listing 3.82: original code 


add eax, ebx 
mul ecx 
Listing 3.83: obfuscated code 

xor esi, 011223344h ; garbage 

add esi, eax ; garbage 

add eax, ebx 

mov edx, eax ; garbage 

shl edx, 4 ; garbage 

mul ecx 

xor esi, ecx ; garbage 


Here the garbage code uses registers which are not used in the real code (ESI and 
EDX). However, the intermediate results produced by the real code may be used by 
the garbage instructions for some extra mess—why not? 


Replacing instructions with bloated equivalents 


* MOV op1, op2 can be replaced by the PUSH op2 / POP opl pair. 


* JMP label can be replaced by the PUSH label / RET pair. IDA will not show 
the references to the label. 


* CALL label can be replaced by the following instructions triplet: 
PUSH label after CALL instruction / PUSH label / RET. 


* PUSH op can also be replaced with the following instructions pair: 
SUB ESP, 4 (or 8) / MOV [ESP], op. 


Always executed/never executed code 


If the developer is sure that ESI at always O at that point: 
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mov esi, 1 

"T ; some code not touching ESI 
dec esi 

"m ; some code not touching ESI 
cmp esi, 0 

jz real code 

; fake luggage 

real code: 


The reverse engineer needs some time to get into it. 
This is also called an opaque predicate. 


Another example (and again, the developer is sure that ESI is always zero): 


; ESI-0 

add eax, ebx ; real code 

mul ecx ; real code 

add eax, esi ; opaque predicate. XOR, AND or SHL, etc, can be here 


instead of ADD. 


Making a lot of mess 


instruction 1 
instruction 2 
instruction 3 


Can be replaced with: 


begin: jmp insl label 
ins2 label: instruction 2 

jmp ins3 label 
ins3 label: instruction 3 

jmp exit: 
insl label: instruction 1 

jmp ins2 label 
exit: 


Using indirect pointers 


dummy datal db 100h dup (0) 
messagel db ‘hello world',0 
dummy data2 db 200h dup (0) 
message2 db 'another message',0 
func proc 
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mov eax, offset dummy datal ; PE or ELF reloc here 
add eax, 100h 
push eax 


call dump string 


mov eax, offset dummy data2 ; PE or ELF reloc here 
add eax, 200h 
push eax 


call dump string 


func endp 


IDA will show references only to dummy dataland dummy data2, but not to the text 
strings. 


Global variables and even functions may be accessed like that. 
Now something slightly more advanced. 


Honestly, | don't know its exact name, but | would call it shifted pointer. This tech- 
nique is quite common, at least in copy protection schemes. 


In short: while writing a value into global memory you use an address, but by reading 
you use a sum of (other) addresses, or maybe a difference. The goal is to hide a real 
address from a reverse engineer who debugs the code or exploring it in IDA (or 
another disassembler). 


This can be a nuisance. 


#include <stdio.h> 


// 64KiB, but it's OK 
unsigned char secret array[0x10000]; 


void check lic key() 


1 
// pretend licence check has been failed 
secret array[0x6123]-1; // 1 mean failed 
printf ("check failed\n"); // exit(0); // / a cracker may patch here 
// or put there another value if check is succeeded 
secret array[0x6123]-0; 

$; 

unsigned char get byte at_0x6000(unsigned char *a) 

1 
return *(a+0x6000) ; 

Hh 


void check again() 


if (get byte at_0x6000(secret_array+0x123)==1) 
1 


// do something mean (add watermark maybe) or report error: 
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printf ("check failedin"); 


} 
else 
{ 
// proceed further 
hi 
}; 
int main() 
{ 
// at start: 
check lic key(); 
// do something 
// ... and while in some very critical part: 
check again(); 
}; 


If compiled by non-optimizing MSVC 2015: 


check lic key proc near 


push ebp 

mov ebp, esp 

mov eax, 1 

imul ecx, eax, 6123h 

mov secret array[ecx], 1 
pop ebp 

retn 


check lic key endp 


get byte at 0x6000 proc near 


a - dword ptr 8 
push ebp 
mov ebp, esp 
mov eax, [ebp+a] 
mov al, [eax+6000h] 
pop ebp 
retn 


get byte at 0x6000 endp 


check again proc near 
push ebp 
mov ebp, esp 


push offset point passed to get byte at 0x6000 
call j get byte at 0x6000 


add esp, 4 

movzx  eax, al 

cmp eax, 1 

jnz short loc 406735 

push offset Format ; "check failed\n" 
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call j printf 


add esp, 4 
loc 406735: 
pop ebp 
retn 
check again endp 


.data:0045F5C0 ; char secret array[65536] 

.data:0045F5C0 secret array db 123h dup(?) 

.data:0045F6E3 ; char point passed to get byte at 0x6000[65245] 
.data:0045F6E3 point passed to get byte at 0x6000 db OFEDDh dup(?) 


You see, IDA can only get two addresses: secret array[] (start of the array) and 
point passed to get byte at 0x6000. 


How to deal with it: you can use hardware breakpoints on memory access operations 
tracer has BPMx options) or symbolic execution engine or maybe you can write a 
plugin for IDA... 


Surely, one array can be used for many values, not limited to boolean ones... 


N.B.: Optimizing MSVC 2015 is smart enough to optimizethe get byte at 0x6000() 
function out. 


3.20.3 Virtual machine / pseudo-code 


A programmer can construct his/her own PL or ISA and interpreter for it. 


(Like the pre-5.0 Visual Basic, .NET or Java machines). The reverse engineer will 
have to spend some time to understand the meaning and details of all of the ISA's 
instructions. 


He/she will also have to write a disassembler/decompiler of some sort. 


3.20.4 Other things to mention 


My own (yet weak) attempt to patch the Tiny C compiler to produce obfuscated code: 
http://blog.yurichev.com/node/58. 


Using the MOV instruction for really complicated things: [Stephen Dolan, mov is 
Turing-complete, (2013)] 22. 


3.20.5 Exercise 
* http://challenges.re/29 


22Also available as http: //www.cl.cam.ac.uk/~sd601/papers/mov. pdf 
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3.21 C++ 


3.21.1 Classes 


A simple example 


Internally, the representation of C++ classes is almost the same as the structures. 


Let's try an example with two variables, two constructors and one method: 


#include <stdio.h> 


class c 
{ 
private: 
int vl; 
int v2; 
public: 
c() // default ctor 
{ 
v1=667; 
v2=999; 
ur 


c(int a, int b) // ctor 
1 

vl=a; 

v2=b; 
3 


void dump() 
{ 


F; 


printf ("%d; %d\n", v1, v2); 


int main() 


class c cl; 
class c c2(5,6); 


cl.dump(); 
c2.dump() ; 


return 0; 


ur 


MSVC: x86 


Here is how the main() function looks like, translated into assembly language: 
Listing 3.84: MSVC 
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_c2$ = -16 ; size = 8 
_cl$ 2-8 ; size = 8 
main PROC 

push ebp 

mov ebp, esp 

sub esp, 16 


lea ecx, DWORD PTR _cl$[ebp] 
call ??@c@@QAE@XZ ; c::c 
push 6 
push 5 
lea ecx, DWORD PTR c2$[ebp] 
call ??@c@@QAE@HH@Z ; c::c 
lea ecx, DWORD PTR _cl$[ebp] 
call ?dump@c@@QAEXXZ ; c::dump 
lea ecx, DWORD PTR c2$[ebp] 
call ?dump@c@@QAEXXZ ; c::dump 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 

main ENDP 


Here's what's going on. For each object (instance of class c) 8 bytes are allocated, 
exactly the size needed to store the 2 variables. 


For c1 a default argumentless constructor ??@c@@QAE@XZ is called. For c2 another 
constructor ??0c@@QAE@HH@Z is called and two numbers are passed as arguments. 


A pointer to the object (this in C++ terminology) is passed in the ECX register. This 
is called thiscall (3.21.1)—the method for passing a pointer to the object. 


MSVC does it using the ECX register. Needless to say, itis not a standardized method, 
other compilers can do it differently, e.g., via the first function argument (like GCC). 


Why do these functions have such odd names? That's name mangling. 


A C++ class may contain several methods sharing the same name but having dif- 
ferent arguments—that is polymorphism. And of course, different classes may have 
their own methods with the same name. 


Name mangling enable us to encode the class name + method name + all method 
argument types in one ASCII string, which is then used as an internal function name. 
That's all because neither the linker, nor the DLL OS loader (mangled names may be 
among the DLL exports as well) knows anything about C++ or OOP”. 


The dump() function is called two times. 


Now let's see the constructors' code: 


Listing 3.85: MSVC 


_this$ = -4 ; size = 4 
??Q0c@@QAE@XZ PROC ; c::c, COMDAT 
; this$ = ecx 
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push ebp 
mov ebp, esp 
push ecx 
mov DWORD PTR this$[ebp], ecx 
mov eax, DWORD PTR this$[ebp] 
mov DWORD PTR [eax], 667 
mov ecx, DWORD PTR _this$[ebp] 
mov DWORD PTR [ecx+4], 999 
mov eax, DWORD PTR _this$[ebp] 
mov esp, ebp 
pop ebp 
ret 0 

??Q0c@@QAE@XZ ENDP ; c::c 


_this$ = -4 ; size = 4 
_a$ = 8 ; size = 4 
b$ = 12 ; size = 4 


??0c@@QAE@HH@Z PROC ; c::c, COMDAT 
; this$ = ecx 
push ebp 
mov ebp, esp 
push ecx 
mov DWORD PTR this$[ebp], ecx 
mov eax, DWORD PTR _this$[ebp] 
mov ecx, DWORD PTR a$[ebp] 
mov DWORD PTR [eax], ecx 
mov edx, DWORD PTR _this$[ebp] 
mov eax, DWORD PTR _b$[ebp] 
mov DWORD PTR [edx+4], eax 
mov eax, DWORD PTR _this$[ebp] 
mov esp, ebp 
pop ebp 
ret 8 
??Q0c@@QAE@HH@Z ENDP ; c::c 


The constructors are just functions, they use a pointer to the structure in ECX, copying 
the pointer into their own local variable, however, it is not necessary. 


From the C++ standard (C++11 12.1) we know that constructors are not required 
to return any values. 


In fact, internally, the constructors return a pointer to the newly created object, i.e., 
this. 


Now the dump() method: 
Listing 3.86: MSVC 


_this$ = -4 ; size = 4 
?dump@c@@QAEXXZ PROC ; c::dump, COMDAT 
; this$ = ecx 

push ebp 

mov ebp, esp 

push ecx 

mov DWORD PTR this$[ebp], ecx 
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mov eax, DWORD PTR this$[ebp] 
mov ecx, DWORD PTR [eax+4] 
push ecx 
mov edx, DWORD PTR _this$[ebp] 
mov eax, DWORD PTR [edx] 
push eax 
push OFFSET ?? C@ 07NJBDCIECQ?$CFd?$DL?5?$CFd?6?$AAQ 
call printf 
add esp, 12 
mov esp, ebp 
pop ebp 
ret 0 

?dump@c@@QAEXXZ ENDP ; c::dump 


Simple enough: dump() takes a pointer to the structure that contains the two int’s 
from ECX, takes both values from it and passes them to printf(). 


The code is much shorter if compiled with optimizations (/0x): 


Listing 3.87: MSVC 


??0cQQQAEQXZ PROC ; c::c, COMDAT 
; this$ = ecx 
mov eax, ecx 
mov DWORD PTR [eax], 667 
mov DWORD PTR [eax+4], 999 
ret 0 
??Q0c@@QAE@XZ ENDP ; c::c 


_a$ = A ; size = 4 
_b$ = ; size = 4 
a PROC ; c::c, COMDAT 


; this$ = ecx 
mov edx, DWORD PTR _b$[esp-4] 
mov eax, ecx 
mov ecx, DWORD PTR a$[esp-4] 
mov DWORD PTR [eax], ecx 
mov DWORD PTR [eax+4], edx 
ret 8 

??Qc@@QAE@HH@Z ENDP ; c::c 


?dump@c@@QAEXXZ PROC ; c::dump, COMDAT 
; this$ = ecx 
mov eax, DWORD PTR [ecx+4] 
mov ecx, DWORD PTR [ecx] 
push eax 
push ecx 
push OFFSET ?? C@ 07NJBDCIECQ?$CFd?$DL?5?$CFd?6?$AAQ 
call printf 
add esp, 12 
ret 0 
?dump@c@@QAEXXZ ENDP ; c::dump 
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That's all. The other thing we must note is that the stack pointer hasn't been cor- 
rected with add esp, Xafterthe constructor has been called. At the same time, the 
constructor has ret 8 instead of RET at the end. 


This is all because the thiscall (3.21.1 on page 683) calling convention is used here, 
which together with the stdcall (6.1.2 on page 932) method offers the callee to cor- 
rect the stack instead of the caller. The ret x instruction adds X to the value in ESP, 
then passes the control to the caller function. 


See also the section about calling conventions (6.1 on page 932). 


It also has to be noted that the compiler decides when to call the constructor and 
destructor—but we already know that from the C++ language basics. 


MSVC: x86-64 


As we already know, the first 4 function arguments in x86-64 are passed in RCX, RDX, 
R8 and R9 registers, all the rest—via the stack. 


Nevertheless, the this pointer to the object is passed in RCX, the first argument of 
the method in RDX, etc. We can see this in the c(int a, int b) method internals: 


Listing 3.88: Optimizing MSVC 2012 x64 


; void dump() 


?dump@c@@QEAAXXZ PROC ; c::dump 
mov r8d, DWORD PTR [rcx+4] 
mov edx, DWORD PTR [rcx] 
lea rcx, OFFSET FLAT:?? CQ 07NJBDCIECQ?$CFd?$DL?5?$CFd?6?$AAQ ; 
"Sd; %d' 
jmp printf 
?dump@c@@QEAAXXZ ENDP ; c::dump 


; c(int a, int b) 


??@c@@QEAA@GHH@Z PROC ; c::c 


mov DWORD PTR [rcx], edx ; lst argument: a 
mov DWORD PTR [rcx+4], r8d ; 2nd argument: b 
mov rax, rcx 

ret 0 


??0c@@QEAA@HH@Z ENDP ; c::c 
; default ctor 


??0c@@QEAA@XZ PROC ; c::c 
mov DWORD PTR [rcx], 667 
mov DWORD PTR [rcx+4], 999 
mov rax, rcx 
ret 0 

??20cQQOEAAQXZ ENDP ; c::c 
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The int data type is still 32-bit in x64 ?^, so that is why 32-bit register parts are used 
here. 


We also see JMP printf instead of RET in the dump() method, that hack we already 
saw earlier: 1.21.1 on page 197. 


GCC: x86 


It is almost the same story in GCC 4.4.1, with a few exceptions. 


Listing 3.89: GCC 4.4.1 


public main 
main proc near 


var 20 - dword ptr -20h 

var 1C - dword ptr -1Ch 

var 18 - dword ptr -18h 

var 10 = dword ptr -10h 

var 8 - dword ptr -8 
push ebp 


mov ebp, esp 
and esp, OFFFFFFFOh 
sub esp, 20h 
lea eax, [esp+20h+var 8] 
mov [esp+20h+var_ 20], eax 
call ZN1cC1Ev 
mov [esp+20h+var_18], 6 
mov [esp+20h+var_1C], 5 
lea eax, [esp+20h+var_10] 
mov [esp+20h+var_ 20], eax 
call ZNIcCIEii 
lea eax, [esp+20h+var 8] 
mov [esp+20h+var_ 20], eax 
call _ZN1c4dumpEv 
lea eax, [esp+20h+var_10] 
mov [esp+20h+var_ 20], eax 
call _ZN1c4dumpEv 
mov eax, 0 
leave 
retn 

main endp 


Here we see another name mangling style, specific to GNU 2°. It can also be noted 
that the pointer to the object is passed as the first function argument—invisible to 
programmer, of course. 


First constructor: 


24 Apparently, for easier porting of 32-bit C/C++ code to x64. 
25There is a good document about the various name mangling conventions in different compilers: 
[Agner Fog, Calling conventions (2015)]. 
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public  ZNICCIEv ; weak 


. ZN1cCIEv proc near ; CODE XREF: main+10 
arg 0 = dword ptr 8 
push ebp 
mov ebp, esp 
mov eax, [ebp«arg 0] 
mov dword ptr [eax], 667 
mov eax, [ebp«arg 0] 
mov dword ptr [eax+4], 999 
pop ebp 
retn 
_ZN1cC1Ev endp 


It just writes two numbers using the pointer passed in the first (and only) argument. 


Second constructor: 


public  ZN1cC1Eii 


_ZN1cC1Eii proc near 

arg 0 - dword ptr 8 

arg 4 = dword ptr  OCh 

arg 8 = dword ptr 10h 
push ebp 
mov ebp, esp 
mov eax, [ebp«arg 0] 
mov edx, [ebptarg 4] 
mov [eax], edx 
mov eax, [ebp«arg 0] 
mov edx, [ebp+arg 8] 
mov [eax+4], edx 
pop ebp 
retn 

_ZN1cC1Eii endp 


This is a function, the analog of which can look like this: 


void ZN1cC1Eii (int *obj, int a, int b) 
1 
*obj-a; 
*(obj*1)-b; 
$; 


...and that is completely predictable. 


Now the dump() function: 


public _ZN1c4dumpEv 
_ZN1c4dumpEv proc near 
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var 18 - dword ptr -18h 
var 14 - dword ptr -14h 
var 10 = dword ptr -10h 
arg 0 - dword ptr 8 
push ebp 
mov ebp, esp 
sub esp, 18h 
mov eax, [ebp«arg 0] 
mov edx, [eax+4] 
mov eax, [ebp«arg 0] 
mov eax, [eax] 
mov [esp+18h+var_10], edx 
mov [esp+18h+var_ 14], eax 
mov [esp+18h+var_18], offset aDD ; "%d; %d\n" 
call _ printf 
leave 
retn 
_ZN1c4dumpEv endp 


This function in its internal representation has only one argument, used as pointer 
to the object (this). 


This function could be rewritten in C like this: 


void ZN1c4dumpEv (int *obj) 


{ 
printf ("%d; %d\n", *obj, *(obj+1)); 
y; 


Thus, if we base our judgment on these simple examples, the difference between 
MSVC and GCC is the style of the encoding of function names (name mangling) and 
the method for passing a pointer to the object (via the ECX register or via the first 
argument). 


GCC: x86-64 


The first 6 arguments, as we already know, are passed in the RDI, RSI, RDX, RCX, 
R8 and R9 ([Michael Matz, Jan Hubicka, Andreas Jaeger, Mark Mitchell, System V 
Application Binary Interface. AMD64 Architecture Processor Supplement, (2013)] ?9) 
registers, and the pointer to this via the first one (RDI) and that is what we see here. 
The int data type is also 32-bit here. 


The JMP instead of RET hack is also used here. 
Listing 3.90: GCC 4.4.6 x64 


; default ctor 


_ZN1cC2Ev: 


26Also available as  https://software.intel.com/sites/default/files/article/402129/ 
mpx- linux64-abi.pdf 
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mov DWORD PTR [rdi], 667 
mov DWORD PTR [rdi+4], 999 
ret 


; c(int a, int b) 


_ZN1cC2Eii: 
mov DWORD PTR [rdi], esi 
mov DWORD PTR [rdi+4], edx 
ret 


; dump () 


_ZN1c4dumpEv: 
mov edx, DWORD PTR [rdi+4] 
mov esi, DWORD PTR [rdi] 
xor eax, eax 
mov edi, OFFSET FLAT:.LCO ; "%d; %d\n" 
jmp printf 


Class inheritance 


Inherited classes are similar to the simple structures we already discussed, but ex- 
tended in inheritable classes. 


Let's take this simple example: 


#include <stdio.h> 


class object 
{ 
public: 

int color; 

object() { }; 

object (int color) { this->color=color; }; 

void print color() { printf ("color=%d\n", color); }; 
y; 


class box : public object 
{ 
private: 
int width, height, depth; 
public: 
box(int color, int width, int height, int depth) 
{ 
this->color=color; 
this->width=width; 
this->height=height ; 
this->depth=depth; 
$; 
void dump() 
1 
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printf ("this is a box. color=%d, width=%d, height=%d, depth=%d7 
4 Mn", color, width, height, depth); 


h 
y; 
class sphere : public object 
1 
private: 
int radius; 
public: 
sphere(int color, int radius) 
1 
this->color=color; 
this->radius=radius; 
}; 
void dump() 
{ 
printf ("this is sphere. color=%d, radius=%d\n", color, radius); 
}; 
}; 
int main() 
{ 
box b(1, 10, 20, 30); 
sphere s(2, 40); 
b.print_color(); 
s.print_color(); 
b.dump() ; 
s.dump(); 
return 0; 
}; 


Let's investigate the generated code of the dump () functions/methods and also 
object::print color(), and see the memory layout for the structures-objects (for 
32-bit code). 


So, here are the dump() methods for several classes, generated by MSVC 2008 with 
/0x and /0b0 options ?/. 


Listing 3.91: Optimizing MSVC 2008 /ObO 


?? Cf O9GCEDOLPA@color?$DN?$CFd?6?$AA@ DB 'color=%d', 0aH, OOH ; 'string' 
?print_color@object@@QAEXXZ PROC ; object::print color, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx] 

push eax 


; 'color=%d', OaH, OOH 


27The /0b0 option stands for disabling inline expansion since function inlining can make our experiment 
harder. 
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push OFFSET ?? C@ O9GCEDOLPAGcolor?$DN?$CFd?6?$AAQ 
call printf 
add esp, 8 
ret 0 
?print_color@object@@QAEXXZ ENDP ; object::print color 


Listing 3.92: Optimizing MSVC 2008 /ObO 


?dump@box@@QAEXXZ PROC ; box::dump, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx+12] 

mov edx, DWORD PTR [ecx+8] 

push eax 

mov eax, DWORD PTR [ecx+4] 

mov ecx, DWORD PTR [ecx] 

push edx 

push eax 

push ecx 


‘this is a box. color=%d, width="%d, height=%d, depth=%d', OaH, 00H ; "stri 
push OFFSET ?? C@ ODGENCNGAADLEthis?5is?5box?4?5color?$DN?$CFd?0?5width 7 
y ?$DN?$CFd?0@ 
call printf 
add esp, 20 
ret 0 

?dump@box@@QAEXXZ ENDP ; box: :dump 


Listing 3.93: Optimizing MSVC 2008 /ObO 


?dump@sphere@@QAEXXZ PROC ; sphere::dump, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx+4] 

mov ecx, DWORD PTR [ecx] 

push eax 

push ecx 


; 'this is sphere. color=%d, radius=%d', OaH, 00H 
push OFFSET ?? C@ OCF@EFEDILDC@this?5is?5sphere?4?5color?$DN?$CFd?0?5 2 
y radius@ 
call printf 
add esp, 12 
ret 0 
?dump@sphere@@QAEXXZ ENDP ; sphere::dump 


ng 


So, here is the memory layout: 
(base class object) 


offset | description 
+0x0 int color 


(inherited classes) 


box: 
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sphere: 


offset | description 


+0x0 int color 


+0x4 int width 


+0x8 | int height 


+0xC | int depth 


offset | description 


+0x0 int color 


+0x4 int radius 


Let’s see main() function body: 


Listing 3.94: Optimizing MSVC 2008 /ObO 


PUBLIC main 
TEXT SEGMENT 


_s$ = -24 ; size = 8 
_b$ = -16 ; size = 16 
main PROC 
sub esp, 24 
push 30 
push 20 
push 10 
push 1 
lea ecx, DWORD PTR _b$[esp+40] 


call ??@box@@QAE@HHHH@Z ; box: :box 
push 40 
push 2 
lea ecx, DWORD PTR _s$[esp+32] 
call ??@sphere@@QAE@HH@Z ; sphere::sphere 
lea ecx, DWORD PTR _b$[esp+24] 
call ?print_color@object@@QAEXXZ ; object::print color 
lea ecx, DWORD PTR _s$[esp+24] 
call ?print_color@object@@QAEXXZ ; object::print color 
lea ecx, DWORD PTR _b$[esp+24] 
call ?dump@box@@QAEXXZ ; box::dump 
lea ecx, DWORD PTR _s$[esp+24] 
call ?dump@sphere@@QAEXXZ ; sphere::dump 
xor eax, eax 
add esp, 24 
ret 0 
_main ENDP 


The inherited classes must always add their fields after the base classes' fields, to 


make it possible for the base class methods to work with their own fields. 


When the object: :print_color() method is called, a pointers to both the box and 
sphere objects are passed as this, and it can work with these objects easily since 


the color field in these objects is always at the pinned address (at offset +0x0). 


It can be said that the object::print color() method is agnostic in relation to the 
input object type as long as the fields are pinned at the same addresses, and this 
condition is always true. 
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And if you create inherited class of the box class, the compiler will add the new fields 
after the depth field, leaving the box class fields at the pinned addresses. 


Thus, the box: :dump() method will work fine for accessing the color, width, height 
and depths fields, which are always pinned at known addresses. 


The code generated by GCC is almost the same, with the sole exception of passing 
the this pointer (as it has been explained above, it is passed as the first argument 
instead of using the ECX register). 


Encapsulation 


Encapsulation is hiding the data in the private sections of the class, e.g. to allow 
access to them only from this class methods. 


However, are there any marks in code the about the fact that some field is private 
and some other— not? 


No, there are no such marks. 


Let's try this simple example: 


#include <stdio.h> 


class box 
{ 
private: 
int color, width, height, depth; 
public: 
box(int color, int width, int height, int depth) 
{ 
this->color=color; 
this->width=width; 
this->height=height; 
this->depth=depth; 
h 
void dump() 
1 
printf ("this is a box. color=%d, width=%d, height=%d, depth=%d 7 
V Mn", color, width, height, depth); 
}; 
$; 


Let's compile it again in MSVC 2008 with /0x and /0b0 options and see the box: : dump() 
method code: 


?dump@box@@QAEXXZ PROC ; box::dump, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx+12] 

mov edx, DWORD PTR [ecx+8] 

push eax 

mov eax, DWORD PTR [ecx+4] 

mov ecx, DWORD PTR [ecx] 

push edx 
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push eax 
push ecx 
'this is a box. color=%d, width=%d, height=%d, depth=%d', OaH, 00H 
push OFFSET ?? Cf ODG@NCNGAADL@this?5is?5box?4?5color?$DN?$CFd?0?5widthy 
y ?$DN?$CFd?0@ 
call printf 
add esp, 20 
ret 0 
?dump@box@@QAEXXZ ENDP ; box: :dump 


Here is a memory layout of the class: 


offset | description 
+0x0 | int color 
+0x4 | int width 
+0x8 | int height 
+0xC | int depth 


All fields are private and not allowed to be accessed from any other function, but 
knowing this layout, can we create code that modifies these fields? 


To do this we'll add the hack oop encapsulation() function, which is not going to 
compile if it looked like this: 


void hack oop encapsulation(class box * o) 
1 
o->width=1; // that code can't be compiled: 
// "error C2248: 'box::width' : cannot access private member 
declared in class 'box'" 


Nevertheless, if we cast the box type to a pointer to an int array, and we modify the 
array of int-s that we have, we can succeed. 


void hack oop encapsulation(class box * o) 


1 
unsigned int *ptr to object=reinterpret_cast<unsigned int*>(0); 
ptr to object[1]=123; 

H 


This function's code is very simple—it can be said that the function takes a pointer 
to an array of int-s for input and writes 123 to the second int: 


?hack_oop_encapsulation@@YAXPAVbox@@@Z PROC ; hack oop encapsulation 
mov eax, DWORD PTR _o$[esp-4] 
mov DWORD PTR [eax+4], 123 
ret 0 

?hack_oop_encapsulation@@YAXPAVbox@@@Z ENDP ; hack oop encapsulation 


Let’s check how it works: 


int main() 


{ 
box b(1, 10, 20, 30); 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


696 


b.dump() ; 


hack oop encapsulation(G&b); 


b.dump() ; 
return 0; 
u 
Let's run: 


this is a box. color=1, width=10, height=20, depth=30 
this is a box. color-1, width=123, height=20, depth=30 


We see that the encapsulation is just protection of class fields only in the compilation 
stage. 


The C++ compiler is not allowing the generation of code that modifies protected 
fields straightforwardly, nevertheless, it is possible with the help of dirty hacks. 


Multiple inheritance 


Multiple inheritance is creating a class which inherits fields and methods from two 
or more classes. 


Let's write a simple example again: 


#include <stdio.h> 


class box 
{ 
public: 
int width, height, depth; 
box() { }; 
box(int width, int height, int depth) 
{ 
this->width=width; 
this->height=height; 
this->depth=depth; 
}; 
void dump() 
{ 


printf ("this is a box. width=%d, height=%d, depth=%d\n", width 
G , height, depth); 


int get volume() 


1 
un 


return width * height * depth; 
Hh 


class solid object 
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public: 
int density; 
solid object() ( $; 
solid object(int density) 
1 


y; 
int get density() 
1 


hi 
void dump() 
{ 


this->density=density; 
return density; 


printf ("this is a solid object. density=%d\n", density); 
h 
}; 


class solid_box: box, solid_object 
{ 
public: 
solid_box (int width, int height, int depth, int density) 
{ 
this->width=width; 
this->height=height; 
this->depth=depth; 
this->density=density; 
}; 
void dump() 
{ 
printf ("this is a solid box. width=%d, height=%d, depth=d, 7 
V density=%d\n", width, height, depth, density); 
$; 
int get weight() { return get volume() * get density(); }; 


int main() 


box b(10, 20, 30); 
solid object so(100); 
solid box sb(10, 20, 30, 3); 


b.dump() ; 
so.dump() ; 
sb.dump() ; 
printf ("%d\n", sb.get weight()); 
return 0; 


Let's compile it in MSVC 2008 with the /0x and /0b0 options and see the code of 
box: :dump(), 
solid object::dump() and solid box::dump(): 
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Listing 3.95: Optimizing MSVC 2008 /ObO 


?dump@box@@QAEXXZ PROC ; box::dump, COMDAT 
; this$ = ecx 
mov eax, DWORD PTR [ecx+8] 
mov edx, DWORD PTR [ecx+4] 
push eax 
mov eax, DWORD PTR [ecx] 
push edx 
push eax 
; ‘this is a box. width=%d, height=%d, depth=%d', OaH, 00H 
push OFFSET ?? C@ OCMGDIKPHDFIQthis?5is?5box?4?5width?$DN?$CFd?0?57 
V height?$DN?$CFd@ 
call printf 
add esp, 16 
ret 0 
?dump@box@@QAEXXZ ENDP ; box::dump 


Listing 3.96: Optimizing MSVC 2008 /ObO 


?dump@solid object@@QAEXXZ PROC ; solid object::dump, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx] 

push eax 

'this is a solid object. density=%d', QaH 

push OFFSET ?? Cf OCC@KICFIINL@this?5is?5solid object?4?5density?$DN? 7 

S $CFd@ 

call printf 

add esp, 8 

ret 0 
?dump@solid object@@QAEXXZ ENDP ; solid object: :dump 


Listing 3.97: Optimizing MSVC 2008 /ObO 


?dump@solid box@@QAEXXZ PROC ; solid box::dump, COMDAT 
; this$ = ecx 
mov eax, DWORD PTR [ecx+12] 
mov edx, DWORD PTR [ecx+8] 
push eax 
mov eax, DWORD PTR [ecx+4] 
mov ecx, DWORD PTR [ecx] 
push edx 
push eax 
push ecx 
; ‘this is a solid box. width=%d, height=%d, depth=%d, density=%d', 0aH 
push OFFSET ?? Cf ODO@HNCNIHNN@this?5is?5solid box?4?5width?$DN?$CFd 7 
y ?0?5heiQ 
call printf 
add esp, 20 
ret 0 
?dump@solid box@@QAEXXZ ENDP ; solid box::dump 


So, the memory layout for all three classes is: 


box class: 
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offset | description 
+0x0 | width 
+0x4 | height 
+0x8 | depth 


solid_object class: 


offset | description 
+0x0 | density 


It can be said that the solid_box class memory layout is united: 


solid_box class: 


offset | description 


+0x0 | width 
+0x4 | height 
+0x8 | depth 


+0xC | density 


The code of the box: :get_volume() and solid object::get density() methods 
is trivial: 


Listing 3.98: Optimizing MSVC 2008 /ObO 


?get_volume@box@@QAEHXZ PROC ; box::get volume, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx+8] 

imul eax, DWORD PTR [ecx+4] 

imul eax, DWORD PTR [ecx] 

ret 0 
?get_volume@box@@QAEHXZ ENDP ; box::get volume 


Listing 3.99: Optimizing MSVC 2008 /ObO 


?get_density@solid object@@QAEHXZ PROC ; solid object::get density, COMDAT 
; this$ = ecx 

mov eax, DWORD PTR [ecx] 

ret 0 
?get_density@solid object@@QAEHXZ ENDP ; solid object::get density 


But the code of the solid box::get weight() method is much more interesting: 


Listing 3.100: Optimizing MSVC 2008 /ObO 


?get_weight@solid box@@QAEHXZ PROC ; solid box::get weight, COMDAT 
; this$ = ecx 

push esi 

mov esi, ecx 

push edi 

lea ecx, DWORD PTR [esi+12] 

call ?get_density@solid object@@QAEHXZ ; solid object: :get density 

mov ecx, esi 

mov edi, eax 

call ?get_volume@box@@QAEHXZ ; box::get volume 

imul eax, edi 
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pop edi 
pop esi 
ret 60 
?get_weight@solid box@@QAEHXZ ENDP ; solid box::get weight 


get weight() just calls two methods, but for get volume() it just passes pointer 
to this, and for get density() it passes a pointer to this incremented by 12 
(or OxC) bytes, and there, in the solid box class memory layout, the fields of the 
solid object class start. 


Thus, the solid object::get density() method will believe like it is dealing with 
the usual solid object class, and the box::get volume() method will work with 
its three fields, believing this is just the usual object of class box. 


Thus, we can say, an object of a class, that inherits from several other classes, is 
representing in memory as a united class, that contains all inherited fields. And each 
inherited method is called with a pointer to the corresponding structure's part. 


Virtual methods 


Yet another simple example: 


#include <stdio.h> 


class object 


{ 
public: 
int color; 
object() { }; 
object (int color) { this->color=color; }; 
virtual void dump() 
{ 
printf ("color=%d\n", color); 
}; 
}; 
class box : public object 
{ 
private: 
int width, height, depth; 
public: 
box(int color, int width, int height, int depth) 
{ 


this->color=color; 
this->width=width; 
this->height=height; 
this->depth=depth; 
}; 
void dump() 
{ 
printf ("this is a box. color=%d, width=%d, height=%d, depth=%d 
S Mn", color, width, height, depth); 
h 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


701 


y 


class sphere : public object 
{ 
private: 
int radius; 
public: 
sphere(int color, int radius) 
1 
this->color=color; 
this->radius=radius; 
$; 
void dump() 
1 


printf ("this is sphere. color=%d, radius=%d\n", color, radius) 7 
Vg 
$; 


int main() 


box b(1, 10, 20, 30); 
sphere s(2, 40); 


object *ol=8b; 
object *o2=&s; 


o1->dump(); 
02-»dump(); 
return 0; 


F 


Class object has a virtual method dump () that is being replaced in the inheriting box 
and sphere classes. 


If we are in an environment where it is not known the type of an object, as in the 
main() function in example, where the virtual method dump( ) is called, the informa- 
tion about its type must be stored somewhere, to be able to call the relevant virtual 
method. 


Let's compile it in MSVC 2008 with the /0x and /0b0 options and see the code of 
main(): 


12 


s$ = -32 ; size 
- 20 


_b$ = -20 ; size 
main PROC 
sub esp, 32 
push 30 
push 20 
push 10 
push 1 
lea ecx, DWORD PTR _b$[esp+48] 
call ??@box@@QAE@HHHH@Z ; box::box 
push 40 
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push 2 
lea ecx, DWORD PTR _s$[esp+40] 
call ??@sphere@@QAE@HH@Z ; sphere::sphere 
mov eax, DWORD PTR _b$[esp+32] 
mov edx, DWORD PTR [eax] 
lea ecx, DWORD PTR _b$[esp+32] 
call edx 
mov eax, DWORD PTR _s$[esp+32] 
mov edx, DWORD PTR [eax] 
lea ecx, DWORD PTR _s$[esp+32] 
call edx 
xor eax, eax 
add esp, 32 
ret 0 

main ENDP 


A pointer to the dump() function is taken somewhere from the object. Where could 
we store the address of the new method? Only somewhere in the constructors: there 
is no other place since nothing else is called in the main() function. ?? 


Let's see the code of the constructor of the box class: 


??_RO?AVbox@@@8 DD FLAT:?? 7type_info@@6B@ ; box "RTTI Type Descriptor' 
DD 00H 
DB '. ?AVbox@@', 00H 


??_R1A@?0A@EA@box@@8 DD FLAT:?? RO?AVbox@@@8 ; box:: RTTI Base Class 
Descriptor at (0,-1,0,64)' 


DD 01H 

DD 00H 

DD OffffffffH 
DD 00H 

DD 040H 


DD FLAT:?? R3box@@8s 


?? R2box@@8 DD FLAT:?? R1AQ?OAGEAQboxQQ8 ; box:: RTTI Base Class Array' 
DD FLAT:?? R1A@?0A@EA@obj ect@@s 


??_R3box@@8 DD 00H ; box::°RTTI Class Hierarchy Descriptor' 
DD 00H 
DD 02H 
DD FLAT:?? R2box@@8 


??_R4box@@6B@ DD 00H ; box:: RTTI Complete Object Locator' 
DD 00H 
DD 00H 
DD FLAT: ??_RO?AVbox@@@s 
DD FLAT: ??_ R3b0x@@8 


??_7box@@6B@ DD FLAT:?? R4box@@6B@ ; box:: vftable' 
DD FLAT : ?dump@box@@UAEXXZ 


28You can read more about pointers to functions in the relevant section:(1.33 on page 483) 
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.color$28 ; size = 4 
_width$ = 12 ; size = 4 
_height$ = 16 ; size = 4 
_depth$ = 20 ; size = 4 


??Qbox@@QAE@HHHH@Z PROC ; box::box, COMDAT 
; this$ = ecx 
push esi 
mov esi, ecx 
call ??0objectQgQAEQGXZ ; object::object 
mov eax, DWORD PTR color$[esp] 
mov ecx, DWORD PTR width$[esp] 
mov edx, DWORD PTR _height$[esp] 
mov DWORD PTR [esi+4], eax 
mov eax, DWORD PTR depth$[esp] 
mov DWORD PTR [esi+16], eax 
mov DWORD PTR [esi], OFFSET ?? 7box@@6B@ 
mov DWORD PTR [esi+8], ecx 
mov DWORD PTR [esi+12], edx 
mov eax, esi 
pop esi 
ret 16 
??0box@@QAE@HHHH@Z ENDP ; box::box 


Here we see a slightly different memory layout: the first field is a pointer to some 
table box: :* vftable' (the name has been set by the MSVC compiler). 


In this table we see a link to a table named 
box:: RTTI Complete Object Locator' and also a link 
to the box: :dump() method. 


These are called virtual methods table and RTTI??. The table of virtual methods has 
the addresses of methods and the RTTI table contains information about types. 


By the way, the RTTI tables are used while calling dynamic cast and typeid in C++. 
You can also see here the class name as a plain text string. 


Thus, a method of the base object class may call the virtual method object::dump(), 
which in turn will call a method of an inherited class, since that information is present 
right in the object's structure. 


Some additional CPU time is needed for doing look-ups in these tables and finding the 
right virtual method address, thus virtual methods are widely considered as slightly 
slower than common methods. 


In GCC-generated code the RTTI tables are constructed slightly differently. 


3.21.2 ostream 


Let's start again with a "hello world" example, but now we are going to use ostream: 


#include <iostream> 


29Run-Time Type Information 
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int main() 


std::cout << "Hello, world!\n"; 


} 


Almost any C++ textbook tells us that the << operation can be defined (overloaded) 
for other types. That is what is done in ostream. We see that operator<< is called 
for ostream: 


Listing 3.101: MSVC 2012 (reduced listing) 


$SG37112 DB ‘Hello, world!', OaH, 00H 


main PROC 
push OFFSET $5G37112 
push OFFSET ?cout@std@@3V?$basic ostream@DU?$char_traits@D@std@@@1@A ; 


std::cout 
call ??$?6U?$char_traits@D@std@@@std@@YAAAV?$basic ostream@DU? /7 
y $char_traits@D@std@@@OGAAV1O@PBD@Z ; 
std: :operator<<<std::char traits<char> > 
add esp, 8 
xor eax, eax 
ret 0 
main ENDP 


Let's modify the example: 


#include <iostream> 


int main() 


{ 
} 


std::cout << "Hello, " << "world!\n"; 


And again, from many C++ textbooks we know that the result of each operator<< 
in ostream is forwarded to the next one. Indeed: 


Listing 3.102: MSVC 2012 


$SG37112 DB 'world!', OaH, 00H 
$9G37113 DB 'Hello, ', 00H 


main PROC 
push OFFSET $5G37113 ; ‘Hello, ' 
push OFFSET ?cout@std@@3V?$basic ostream@DU?$char_traits@D@std@@@1@A ; 


std::cout 

call ??$?6U?$char_traits@D@std@@@std@@YAAAV?$basic ostream@DU? 7 
y $char traitsqDestdeggogAAVIOQPBDGZ ; 

std: :operator<<<std::char traits<char> > 

add esp, 8 


push OFFSET $SG37112 ; 'world!' 

push eax ; result of previous function execution 
call ??$?6U?$char_traits@D@std@@@std@@YAAAV?$basic ostream@DU? 7 
y $char traitseDestdeggogAAVIOQPBDGZ ; 

std: :operator<<<std::char traits<char> > 
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add esp, 8 


xor eax, eax 
ret 0 
main ENDP 


If we would rename operator«« method name to f(), that code will looks like: 


f(f(std::cout, "Hello, "), "world!"); 


GCC generates almost the same code as MSVC. 


3.21.3 References 


In C++, references are pointers (3.23 on page 756) as well, but they are called safe, 
because it is harder to make a mistake while dealing with them (C++11 8.3.2). 


For example, reference must always be pointing to an object of the corresponding 
type and cannot be NULL [Marshall Cline, C++ FAQ8.6]. 


Even more than that, references cannot be changed, it is impossible to point them 
to another object (reseat) [Marshall Cline, C++ FAQ8.5]. 


If we are going to change the example with pointers (3.23 on page 756) to use 
references instead ... 


void f2 (int x, int y, int & sum, int & product) 
1 
sum-x-y ; 
product=x*y; 
$; 


... then we can see that the compiled code is just the same as in the pointers example 
(3.23 on page 756): 


Listing 3.103: Optimizing MSVC 2010 


_x$ = 8 ; size = 4 

_y$ = 12 ; size = 4 

 sum$ = 16 ; size = 4 

_product$ = 20 ; size = 4 

? f2@@YAXHHAAHO@Z PROC he 
mov ecx, DWORD PTR y$[esp-4] 
mov eax, DWORD PTR _x$[esp-4] 
lea edx, DWORD PTR [eax+ecx] 


imul eax, ecx 
mov ecx, DWORD PTR product$[esp-4] 


push esi 
mov esi, DWORD PTR _sum$[esp] 
mov DWORD PTR [esi], edx 
mov DWORD PTR [ecx], eax 
pop esi 
ret 0 
?f2@@YAXHHAAHO@Z ENDP = f2 
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on page 683.) 


Hence, C++ references are as much efficient as usual pointers. 


3.21.4 STL 


N.B.: all examples here were checked only in 32-bit environment. x64 wasn't checked. 


std::string 


Internals 


Many string libraries [Dennis Yurichev, C/C++ programming language notes2.2] im- 
plement a structure that contains a pointer to a string buffer, a variable that al- 
ways contains the current string length (which is very convenient for many func- 
tions: [Dennis Yurichev, C/C++ programming language notes2.2.1]) and a variable 
containing the current buffer size. 


The string in the buffer is usually terminated with zero, in order to be able to pass a 
pointer to the buffer into the functions that take usual C ASCIIZ strings. 


It is not specified in the C++ standard how std::string has to be implemented, how- 
ever, it is usually implemented as explained above. 


The C++ string is not a class (as QString in Qt, for instance) but a template (ba- 
sic string), this is made in order to support various character types: at least char 
and wchar t. 


So, std::string is a class with char as its base type. 


And std::wstring is a class with wchar t as its base type. 
MSVC 


The MSVC implementation may store the buffer in place instead of using a pointer 
to a buffer (if the string is shorter than 16 symbols). 


This implies that a short string is to occupy at least 16 + 4 + 4 = 24 bytes in 32-bit 
environment or at least 16 + 8 + 8 = 32 


bytes in 64-bit one, and if the string is longer than 16 characters, we also have to 
add the length of the string itself. 


Listing 3.104: example for MSVC 


#include <string> 
#include <stdio.h> 


struct std string 


{ 


union 


{ 
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char buf[16]; 


char* ptr; 
} u; 
size t size; // AKA 'Mysize' in MSVC 
size t capacity; // AKA 'Myres' in MSVC 
}; 
void dump_std_string(std::string s) 
{ 
struct std string *p=(struct std_string*)&s; 
printf ("[%s] size:%d capacity:%d\n", p->size>16 ? p->u.ptr : p->u.buf, 2 
V p->size, p->capacity); 
$; 
int main() 
1 
std::string sl="a short string"; 
std::string s2-"a string longer than 16 bytes"; 
dump std string(s1); 
dump std string(s2); 
// that works without using c str() 
printf ("%s\n", &s1); 
printf ("%s\n", s2); 
$; 


Almost everything is clear from the source code. 
A couple of notes: 


If the string is shorter than 16 symbols, a buffer for the string is not to be allocated 
in the heap. 


This is convenient because in practice, a lot of strings are short indeed. 
Looks like that Microsoft's developers chose 16 characters as a good balance. 


One very important thing here can be seen at the end of main(): we're not using 
the c_str() method, nevertheless, if we compile and run this code, both strings will 
appear in the console! 


This is why it works. 


In the first case the string is shorter than 16 characters and the buffer with the string 
is located in the beginning of the std::string object (it can be treated as a structure). 
printf() treats the pointer as a pointer to the null-terminated array of characters, 
hence it works. 


Printing the second string (longer than 16 characters) is even more dangerous: it is 
a typical programmer's mistake (or typo) to forget to write c str(). 


This works because at the moment a pointer to buffer is located at the start of struc- 
ture. 
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This may stay unnoticed for a long time, until a longer string appears there at some 
time, then the process will crash. 


GCC 


GCC's implementation of this structure has one more variable—reference count. 


One interesting fact is that in GCC, a pointer to an instance of std::string instance 
points not to the beginning of the structure, but to the buffer pointer. In libstdc++- 
v3\include\bits\basic_string.h we can read that it was done for more convenient de- 


bugging: 
* The reason you want M data pointing to the character %array and 
* not the Rep is so that the debugger can see the string 
* contents. (Probably we should add a non-inline member to get 
* the Rep for the debugger to use, so users can check the actual 
xk 


string length.) 


basic_string.h source code 


We consider this in our example: 


Listing 3.105: example for GCC 


#include <string> 
#include <stdio.h> 


struct std string 


{ 


$; 


size t length; 
size t capacity; 
size t refcount; 


void dump std string(std::string s) 


{ 


int 


char *pl=*(char**)&s; // GCC type checking workaround 

struct std string *p2=(struct std string*)(pl-sizeof(struct std string) 
V); 

printf ("[%s] size:%d capacity:%d\n", pl, p2->length, p2-»capacity); 


main() 


std::string sl="a short string"; 
std::string s2-"a string longer than 16 bytes"; 


dump std string(s1); 
dump std string(s2); 


// GCC type checking workaround: 
printf ("%s\n", *(char**)&s1); 
printf ("%s\n", *(char**)&s2) ; 
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PE 


Atrickery has to be used to imitate the mistake we already have seen above because 
GCC has stronger type checking, nevertheless, printf() works here without c str() as 
well. 


A more advanced example 


#include <string> 
#include <stdio.h> 


int main() 

{ 
std::string sl="Hello, "; 
std::string s2="world!\n"; 
std::string s3=s1+s2; 


printf ("%s\n", s3.c str()); 


Listing 3.106: MSVC 2012 


$5G39512 DB ‘Hello, ', 00H 
$5G39514 DB 'world!', OaH, 00H 
$5G39581 DB '%s', OaH, 00H 


_s2$ = -72 ; size = 24 
_s3$ = -48 ; size = 24 
_s1$ = -24 ; size = 24 
main PROC 

sub esp, 72 

push 7 


push OFFSET $5G39512 

lea ecx, DWORD PTR _s1$[esp+80] 

mov DWORD PTR _s1$[esp+100], 15 

mov DWORD PTR _sl1$[esp+96], 0 

mov BYTE PTR _sl$[esp+80], O 

call ?assign@?$basic string@DU?$char_ traits@D@std@e@V? ^ 

V $allocator@D@2@@std@@QAEAAV12@PBDI@Z ; 

std: :basic string<char,std::char traits<char>,std::allocator<char> >::assi 


push 7 

push OFFSET $SG39514 

lea ecx, DWORD PTR _s2$[esp+80] 

mov DWORD PTR _s2$[esp+100], 15 

mov DWORD PTR _s2$[esp+96], 0 

mov BYTE PTR _s2$[esp+80], 0 

call ?assign@?$basic string@DU?$char_ traits@D@std@e@V? ” 

V $allocator@D@2@@std@@QAEAAV12@PBDI@Z ; 

std: :basic string<char,std::char traits<char>,std::allocator<char> >::assi 
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lea eax, DWORD PTR _s2$[esp+72] 

push eax 

lea eax, DWORD PTR _s1$[esp+76] 

push eax 

lea eax, DWORD PTR _s3$[esp+80] 

push eax 

call ??$?HDU?$char_traits@D@std@@V?$allocator@D@1@@std@@YA?AV? 7 

S $basic_string@DU?$char_traits@D@std@a@V?$al lLocator@DE@Z2@@O@GABV1O@0@Z ; 
std: :operatort+<char,std::char traits<char>,std::allocator<char> > 


; inlined c str() method: 

cmp DWORD PTR _s3$[esp+104], 16 
lea eax, DWORD PTR _s3$[esp+84] 
cmovae eax, DWORD PTR _s3$[esp+84] 


push eax 

push OFFSET $5G39581 
call printf 

add esp, 20 


cmp DWORD PTR _s3$[esp+92], 16 
jb SHORT $LN119@main 
push DWORD PTR _s3$[esp+72] 
call ??3@YAXPAX@Z ; operator delete 
add esp, 4 
$LN119@main: 
cmp DWORD PTR _s2$[esp+92], 16 
mov DWORD PTR _s3$[esp+92], 15 
mov DWORD PTR _s3$[esp+88], 0 
mov BYTE PTR _s3$[esp+72], 0 
jb SHORT $LN151@main 
push DWORD PTR _s2$[esp+72] 
call ??3@YAXPAX@Z ; operator delete 
add esp, 4 
$LN151@main: 
cmp DWORD PTR _sl$[esp+92], 16 
mov DWORD PTR _s2$[esp+92], 15 
mov DWORD PTR _s2$[esp+88], 0 
mov BYTE PTR _s2$[esp+72], 0 
jb SHORT $LN195@main 
push DWORD PTR _s1$[esp+72] 
call ??3@YAXPAX@Z ; operator delete 
add esp, 4 
$LN195@main: 
xor eax, eax 
add esp, 72 
ret 0 
main ENDP 


The compiler does not construct strings statically: it would not be possible anyway 
if the buffer needs to be located in the heap. 


Instead, the ASCIIZ strings are stored in the data segment, and later, at runtime, 
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with the help of the "assign" method, the s1 and s2 strings are constructed. And 
with the help of operator-, the s3 string is constructed. 


Please note that there is no call to the c str() method, because its code is tiny enough 
so the compiler inlined it right there: if the string is shorter than 16 characters, a 
pointer to buffer is left in EAX, otherwise the address of the string buffer located in 
the heap is fetched. 


Next, we see calls to the 3 destructors, they are called if the string is longer than 
16 characters: then the buffers in the heap have to be freed. Otherwise, since all 
three std::string objects are stored in the stack, they are freed automatically, when 
the function ends. 


As a consequence, processing short strings is faster, because of less heap accesses. 


GCC code is even simpler (because the GCC way, as we saw above, is to not store 
shorter strings right in the structure): 


Listing 3.107: GCC 4.8.1 


.LC0: 

.string "Hello, " 
.LC1: 

.string "world!\n" 
main: 

push ebp 

mov ebp, esp 

push edi 

push esi 

push ebx 

and esp, -16 

sub esp, 32 


lea ebx, [esp+28] 

lea edi, [esp+20] 

mov DWORD PTR [esp+8], ebx 

lea esi, [esp+24] 

mov DWORD PTR [esp+4], OFFSET FLAT:.LCO 
mov DWORD PTR [esp], edi 


call ZNSsCIEPKCRKSaICE 

mov DWORD PTR [esp+8], ebx 

mov DWORD PTR [esp+4], OFFSET FLAT:.LC1 
mov DWORD PTR [esp], esi 

call _ZNSsC1EPKcRKSaIcE 


mov DWORD PTR [esp+4], edi 
mov DWORD PTR [esp], ebx 


call _ZNSsC1ERKSs 


mov DWORD PTR [esp+4], esi 
mov DWORD PTR [esp], ebx 
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call ZNSs6appendERKSs 


; inlined c str(): 
mov eax, DWORD PTR [esp+28] 
mov DWORD PTR [esp], eax 


call puts 


mov eax, DWORD PTR [esp+28] 

lea ebx, [esp+19] 

mov DWORD PTR [esp+4], ebx 

sub eax, 12 

mov DWORD PTR [esp], eax 

call ZNSs4 Rep10 M disposeERKSaICE 
mov eax, DWORD PTR [esp+24] 

mov DWORD PTR [esp+4], ebx 

sub eax, 12 

mov DWORD PTR [esp], eax 

call ZNSs4 Rep10 M disposeERKSaICE 
mov eax, DWORD PTR [esp+20] 

mov DWORD PTR [esp+4], ebx 

sub eax, 12 

mov DWORD PTR [esp], eax 

call ZNSs4 Rep10 M disposeERKSaICE 
lea esp, [ebp-12] 

xor eax, eax 

pop ebx 

pop esi 

pop edi 

pop ebp 

ret 


It can be seen that it's not a pointer to the object that is passed to destructors, but 
rather an address 12 bytes (or 3 words) before, ¡.e., a pointer to the real start of the 
structure. 


std::string as a global variable 
Experienced C++ programmers knows that global variables of STL% types can be 


defined without problems. 
Yes, indeed: 


#include <stdio.h> 
#include <string> 


std::string s="a string"; 


int main() 


{ 


30(C++) Standard Template Library 
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printf ("%s\n", s.c str()); 
$; 


But how and where std::string constructor will be called? 
In fact, this variable is to be initialized even before main () start. 


Listing 3.108: MSVC 2012: here is how a global variable is constructed and also its 
destructor is registered 


??  EsQQYAXXZ PROC 
push 8 
push OFFSET $5G39512 ; ‘a string' 
mov ecx, OFFSET ?s@@3V?$basic string@DU?$char_ traits@D@std@@V? 7 
y $allocator@D@2@@std@@A ; 


call ?assign@?$basic stringeDU?$char_traitseDastdaav? ^ 
y $allocator@D@2@@std@@QAEAAV12@PBDI@Z ; 
std: :basic string«char,std::char traits<char>,std::allocator<char> >::assign 
push OFFSET ?? Fs@@YAXXZ ; "dynamic atexit destructor for 's'' 
call atexit 
pop ecx 
ret 0 

??  EsQQYAXXZ ENDP 


Listing 3.109: MSVC 2012: here a global variable is used in main() 


$5G39512 DB 'a string', 00H 
$5G39519 DB '%s', OaH, OOH 


main PROC 
cmp DWORD PTR ?s@@3V?$basic string@DU?$char_ traits@D@std@e@V? ” 
y $allocator@D@2@@std@@A+20, 16 
mov eax, OFFSET ?s@@3V?$basic string@DU?$char_traits@D@std@@V? 7 
y $allocator@D@2@@std@@A ; 
S 


cmovae eax, DWORD PTR ?s@@3V?$basic string@DU?$char_ traits@D@std@@V? ^ 
y $allocator@D@2@@s td@@A 
push eax 
push OFFSET $5G39519 ; '%s' 
call printf 
add esp, 8 
xor eax, eax 
ret 0 
main ENDP 


Listing 3.110: MSVC 2012: this destructor function is called before exit 


??  FsQQYAXXZ PROC 
push ecx 
cmp DWORD PTR ?s@@3V?$basic stringgDU?$char traits(qDQastd(qQV? - 
y $allocator@D@2@@std@@A+20, 16 
jb SHORT $LN23@dynamic 
push esi 
mov esi, DWORD PTR ?s@@3V?$basic string@DU?$char_traits@D@std@@Vv?/ 
y $allocator@D@2@@s td@@A 
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lea ecx, DWORD PTR $T2[esp+8] 

call ??0?$ Wrap alloca@V?$allocator@D@std@@@std@@QAE@XZ 

push OFFSET ?s@@3V?$basic string@DU?$char_traits@D@std@aV? ^ 
y $allocator@D@2@@std@@A ; 


les ecx, DWORD PTR $T2[esp+12] 
call ??$destroy@PAD@?$ Wrap alloc@V?$allocator@D@std@@@std@@QAEXPAPAD@Z 
lea ecx, DWORD PTR $T1[esp+8] 
call ??0?$ Wrap alloca@V?$allocator@D@std@@@std@@QAE@XZ 
push esi 
call ??3@YAXPAX@Z ; operator delete 
add esp, 4 
esi 


pop 
$LN23@dynamic: 


?? 


mov DWORD PTR ?s@@3V?$basic_ string@DU?$char_ traits@D@std@@V? 7 
y $allocator@D@2@@std@@A+20, 15 

mov DWORD PTR ?s@@3V?$basic string@DU?$char_traits@D@std@a@Vv? 7 
y $allocator@D@2@@std@@A+16, 0 

mov BYTE PTR ?s@@3V?$basic string@DU?$char_traits@D@std@@V?/ 
y $allocator@D@2@@std@@A, O 

pop ecx 

ret 0 


__Fs@@YAXXZ ENDP 


In fact, a special function with all constructors of global variables is called from CRT, 
before main(). 


More than that: with the help of atexit() another function is registered, which contain 
calls to all destructors of such global variables. 


GCC works likewise: 


Listing 3.111: GCC 4.8.1 


main: 


push ebp 

mov ebp, esp 

and esp, -16 

sub esp, 16 

mov eax, DWORD PTR s 

mov DWORD PTR [esp], eax 
call puts 

xor eax, eax 

leave 

ret 


.LC0: 


.string "a string" 


GLOBAL sub I s: 


sub esp, 44 

lea eax, [esp+31] 

mov DWORD PTR [esp+8], eax 

mov DWORD PTR [esp+4], OFFSET FLAT: .LCO 

mov DWORD PTR [esp], OFFSET FLAT:s 

call _ZNSsC1EPKcRKSaIcE 

mov DWORD PTR [esp+8], OFFSET FLAT: dso handle 
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mov DWORD PTR [esp+4], OFFSET FLAT:s 
mov DWORD PTR [esp], OFFSET FLAT: ZNSsDIEv 
call  cxa atexit 


add esp, 44 
ret 
.LFE645: 
.size GLOBAL sub I s, .- GLOBAL sub I s 
.section .init array,"aw" 
.align 4 
.long | GLOBAL sub Is 
.globl s 
.bss 
.align 4 
.type s, @object 
.size s, 4 
S: 
.zero 4 


.hidden | dso handle 


But it does not create a separate function for this, each destructor is passed to 
atexit(), one by one. 


std::list 


This is the well-known doubly-linked list: each element has two pointers, to the pre- 
vious and next elements. 


This implies that the memory footprint is enlarged by 2 words for each element (8 
bytes in 32-bit environment or 16 bytes in 64-bit). 


C++ STL just adds the “next” and “previous” pointers to the existing structure of 
the type that you want to unite in a list. 


Let's work out an example with a simple 2-variable structure that we want to store 
in a list. 


Although the C++ standard does not say how to implement it, both MSVC's and 
GCC's implementations are straightforward and similar, so here is only one source 
code for both: 


#include <stdio.h> 
#include <list> 
#include <iostream> 


struct a 
{ 
int x; 
int y; 
F 


struct List_node 
{ 
struct List_node* _Next; 
struct List node* Prev; 
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int x; 
int y; 
$; 
void dump_List_node (struct List_node *n) 
1 
printf ("ptr=0x%p  Next-0xs*p  Prev-0x*sp x=%d y=%d\n", 
n, n-» Next, n-» Prev, n->x, n-»y); 
$; 
void dump List vals (struct List node* n) 
1 
struct List node* currentzn; 
for (;;) 
1 
dump List node (current); 
current=current-> Next; 
if (current==n) // end 
break; 
$; 
h 


void dump List val (unsigned int *a) 


{ 
#ifdef MSC VER 
// GCC implementation does not have "size" field 
printf ("_Myhead=0x%p, Mysize=%d\n", a[0], a[1]); 
#endif 
dump List vals ((struct List node*)a[0]); 
}; 


int main() 


{ 


std::list<struct a> l; 


printf ("* empty list:\n"); 
dump List val((unsigned int*)(void*)&l); 


struct a t1; 
tl.x-1; 

tl.y=2; 
l.push_front (t1); 
t1.x=3; 

tl.y-4; 

l.push front (t1); 
tl1.x-25; 

tl.y=6; 
l.push_back (t1); 


printf ("* 3-elements list: An"); 
dump List val((unsigned int*) (void*)&l); 
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std::list«struct a»::iterator tmp; 

printf ("node at .begin:\n"); 

tmp=1.begin(); 

dump List node ((struct List node *)*(void**)&tmp); 
printf ("node at .end:\n"); 

tmp=1.end(); 

dump List node ((struct List node *)*(void**)&tmp); 


printf ("* let's count from the beginning:\n"); 
std::list«struct a>::iterator it=l.begin(); 
printf ("1st element: %d %d\n", (*it).x, (*it).y); 


it++; 
printf ("2nd element: %d %d\n", (*it).x, (*it).y); 
ite; 
printf ("3rd element: %d %d\n", (*it).x, (*it).y); 
it++; 


printf ("element at .end(): %d %d\n", (*it).x, (*it).y); 


printf ("* let's count from the end:\n"); 

std::list<struct a»::iterator it2=l.end(); 

printf ("element at .end(): %d %d\n", (*it2).x, (*it2).y); 
it2--; 

printf ("3rd element: %d %d\n", (*it2).x, (*it2).y); 


it2--; 
printf ("2nd element: %d %d\n", (*it2).x, (*it2).y); 
it2--; 


printf ("1st element: %d %d\n", (*it2).x, (*it2).y); 


printf ("removing last element...\n"); 
l.pop back(); 
dump List val((unsigned int*) (void*)&l); 


GCC 


Let's start with GCC. 


When we run the example, we'll see a long dump, let's work with it in pieces. 


* empty list: 
ptr-0x0028fe90  Next-0x0028fe90  Prev-0x0028fe90 x=3 y=0 


Here we see an empty list. 


Despite the fact it is empty, it has one element with garbage (AKA dummy node) in 
x and y. Both the "next" and "prev" pointers are pointing to the self node: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


718 


list.begin() 


Variable ; 
EMI list.end() 


Y=garbage 


At this moment, the .begin and .end iterators are equal to each other. 
If we push 3 elements, the list internally will be: 


* 3-elements List: 


ptr=0x000349a0  Next-0x00034988 Prev=0x0028fe90 x=3 y=4 
ptr=0x00034988 Next=0x00034b40 _Prev=0x000349a0 x=1 y=2 
ptr=0x00034b40  Next-0x0028fe90  Prev-0x00034988 x=5 y=6 
ptr=0x0028fe90  Next-0x000349a0  Prev-0x00034b40 x=5 y=6 


The last element is still at OX0028fe90, it not to be moved until the list's disposal. 


It still contain random garbage in x and y (5 and 6). By coincidence, these values 
are the same as in the last element, but it doesn't mean that they are meaningful. 


Here is how these 3 elements are stored in memory: 


Variable 
std::list 


list.begin() list.end() 


X=1st ele- X=2nd ele- X=3rd ele- X=garbage 

ment ment ment 

Y- 1st ele- Y=2nd ele- Y=3rd ele- Y=garbage 
ment 


ment ment 
The | variable always points to the first node. 
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The .begin() and .end() iterators are not variables, but functions, which when called 
return pointers to the corresponding nodes. 


Having a dummy element (AKA sentinel node) is a very popular practice in imple- 
menting doubly-linked lists. 


Without it, a lot of operations may become slightly more complex and, hence, slower. 


The iterator is in fact just a pointer to a node. list.begin() and list.end() just return 
pointers. 


node at .begin: 

ptr=0x000349a0  Next-0x00034988 Prev=0x0028fe90 x=3 y=4 
node at .end: 

ptr=0x0028fe90  Next-0x000349a0  Prev-0x00034b40 x=5 y=6 


The fact that the last element has a pointer to the first and the first element has a 
pointer to the last one remind us of circular lists. 


This is very helpful here: having a pointer to the first list element, i.e., that is in the 
l variable, it is easy to get a pointer to the last one quickly, without the necessity to 
traverse the whole list. 


Inserting an element at the end of the list is also quick, thanks to this feature. 


operator-- and operator++ just set the current iterator's value to the 
current node-»prev or current node-»next values. 


The reverse iterators (.rbegin, .rend) work just as the same, but in reverse. 


operator* just returns a pointer to the point in the node structure, where the user's 
structure starts, i.e., a pointer to the first element of the structure (z). 


The list insertion and deletion are trivial: just allocate a new node (or deallocate) 
and update all pointers to be valid. 


That's why an iterator may become invalid after element deletion: it may still point 
to the node that has been already deallocated. This is also called a dangling pointer. 


And of course, the information from the freed node (to which iterator still points) 
cannot be used anymore. 


The GCC implementation (as of 4.8.1) doesn't store the current size of the list: this 
implies a slow .size() method: it has to traverse the whole list to count the elements, 
because it doesn't have any other way to get the information. 


This means that this operation is O(n), i.e., it steadily gets slower as the list grows. 


Listing 3.112: Optimizing GCC 4.8.1 -fno-inline-small-functions 


main proc near 
push ebp 
mov ebp, esp 
push esi 
push ebx 
and esp, OFFFFFFFOh 
sub esp, 20h 
lea ebx, [esp+10h] 
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mov dword ptr [esp], offset s ; "* empty list:" 
mov [esp«10h], ebx 

mov [esp+14h], ebx 

call puts 

mov [esp], ebx 

call _Z13dump List valPj ; dump List val(uint *) 
lea esi, [esp+18h] 

mov [esp+4], esi 

mov [esp], ebx 

mov dword ptr [esp+18h], 1 ; X for new element 
mov dword ptr [esp+1Ch], 2 ; Y for new element 
call ZNSt4listIlaSaISO EE10push frontERKSO ; 
std::list«a,std::allocator«a»»::push front(a const&) 
mov [esp+4], esi 

mov [esp], ebx 

mov dword ptr [esp+18h], 3 ; X for new element 
mov dword ptr [esp+1Ch], 4 ; Y for new element 
call ZNSt4listIlaSaISO EE10push frontERKSO ; 
std::list«a,std::allocator«a»»::push front(a const&) 
mov dword ptr [esp], 10h 

mov dword ptr [esp+18h], 5 ; X for new element 
mov dword ptr [esp+1Ch], 6 ; Y for new element 
call Znwj ; operator new(uint) 

cmp eax, OFFFFFFF8h 

jz short loc 80002A6 

mov ecx, [esp+1Ch] 

mov edx, [esp+18h] 

mov [eax+@Ch], ecx 

mov [eax+8], edx 


loc 80002A6: ; CODE XREF: main+86 
mov [esp+4], ebx 
mov [esp], eax 
call ZNSt8 detaill5 List node base7 M hookEPSO ; 
std:: detail:: List node base:: M hook(std::  detail:: List node base*) 
mov dword ptr [esp], offset a3ElementsList ; "* 3-elements list:” 
call puts 
mov [esp], ebx 
call Zi13dump List valPj ; dump List val(uint *) 
mov dword ptr [esp], offset aNodeAt begin ; "node at .begin:" 
call puts 
mov eax, [esp+10h] 
mov [esp], eax 
call Zl14dump List nodeP9List node ; dump List node(List node *) 
mov dword ptr [esp], offset aNodeAt end ; "node at .end:" 
call puts 
mov [esp], ebx 
call Zl14dump List nodeP9List node ; dump List node(List node *) 
mov dword ptr [esp], offset aLetSCountFromT ; "* let's count from the 
beginning:" 
call puts 
mov esi, [esp+10h] 
mov eax, [esi+0Ch] 
mov [esp+0Ch], eax 
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mov eax, [esi+8] 

mov dword ptr [esp+4], offset alstElementDD ; "1st element: %d %d\n" 
mov dword ptr [esp], 1 

mov [esp+8], eax 

call  printf chk 

mov esi, [esi] ; operator++: get ->next pointer 

mov eax, [esi+0Ch] 

mov [esp+0Ch], eax 

mov eax, [esi+8] 

mov dword ptr [esp+4], offset a2ndElementDD ; "2nd element: %d %d\n" 
mov dword ptr [esp], 1 

mov [esp+8], eax 

call  printf chk 

mov esi, [esi] ; operator++: get ->next pointer 

mov eax, [esi+0Ch] 

mov [esp+0Ch], eax 

mov eax, [esi+8] 

mov dword ptr [esp+4], offset a3rdElementDD ; "3rd element: %d %d\n" 
mov dword ptr [esp], 1 

mov [esp+8], eax 

call  printf chk 

mov eax, [esi] ; operator++: get ->next pointer 

mov edx, [eax+0Ch] 

mov [esp+@Ch], edx 

mov eax, [eax+8] 

mov dword ptr [esp+4], offset aElementAt endD ; 


"element at .end(): %d %d\n" 
mov dword ptr [esp], 1 


mov [esp+8], eax 
call  printf chk 
mov dword ptr [esp], offset aLetSCountFro 0 ; "* let's count from the 


end:" 

call puts 

mov eax, [esp+1Ch] 

mov dword ptr [esp+4], offset aElementAt endD ; 


"element at .end(): %d %d\n" 
mov dword ptr [esp], 1 


mov [esp+0Ch], eax 

mov eax, [esp+18h] 

mov [esp+8], eax 

call  printf chk 

mov esi, [esp+14h] 

mov eax, [esi+0Ch] 

mov [esp+0Ch], eax 

mov eax, [esi+8] 

mov dword ptr [esp+4], offset a3rdElementDD ; "3rd element: %d %d\n" 
mov dword ptr [esp], 1 

mov [esp+8], eax 

call  printf chk 

mov esi, [esi+4] ; operator--: get ->prev pointer 

mov eax, [esi+0Ch] 

mov [esp+0Ch], eax 

mov eax, [esi+8] 

mov dword ptr [esp+4], offset a2ndElementDD ; "2nd element: %d %d\n" 
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mov dword ptr [esp], 1 

mov [esp+8], eax 

call  printf chk 

mov eax, [esi+4] ; operator--: get ->prev pointer 
mov edx, [eax+0Ch] 

mov [esp+@Ch], edx 

mov eax, [eax+8] 

mov dword ptr [esp+4], offset alstElementDD ; "1st element: 
mov dword ptr [esp], 1 

mov [esp+8], eax 

call  printf chk 


?sd %d\n" 


mov dword ptr [esp], offset aRemovingLastEl ; "removing last element..." 


call puts 
mov esi, [esp+14h] 
mov [esp], esi 
call ZNSt8 detaill5 List node base9 M unhookEv ; 
std:: detail:: List node base:: M unhook(void) 
mov [esp], esi ; void * 
call ZdlPv ; operator delete(void *) 
mov [esp], ebx 
call Zl13dump List valPj ; dump List val(uint *) 
mov [esp], ebx 
call ZNSt10 List baseIlaSaISO EE8 M clearEv ; 
std:: List base<a,std::allocator<a>>:: M clear(void) 
lea esp, [ebp-8] 
xor eax, eax 
pop ebx 
pop esi 
pop ebp 
retn 
main endp 


Listing 3.113: The whole output 


* empty list: 


ptr-0x0028fe90  Next-0x0028fe90  Prev-0x0028fe90 x=3 y=0 
* 3-elements list: 

ptr=0x000349a0  Next-0x00034988 Prev=0x0028fe90 x-3 y=4 
ptr=0x00034988  Next-0x00034b40  Prev-0x000349a0 x=1 y=2 
ptr=0x00034b40  Next-0x0028fe90  Prev-0x00034988 x=5 y=6 
ptr=0x0028fe90  Next-0x000349a0  Prev-0x00034b40 x=5 y=6 
node at .begin: 

ptr=0x000349a0  Next-0x00034988 Prev=0x0028fe90 x-3 y=4 


node at .end: 

ptr-0x0028fe90 Next=0x000349a0  Prev-0x00034b40 x=5 
* let's count from the beginning: 
lst element: 3 4 

2nd element: 1 2 

3rd element: 5 6 

element at .end(): 5 6 

* let's count from the end: 
element at .end(): 5 6 

3rd element: 5 6 

2nd element: 1 2 


< 
ll 
oO 
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lst element: 3 4 

removing last element... 

ptr=0x000349a0  Next-0x00034988 Prev=0x0028fe90 x-3 y=4 
ptr=0x00034988 Next=0x0028fe90 Prev=0x000349a0 x=1 y=2 
ptr=0x0028fe90  Next-0x000349a0  Prev-0x00034988 x=5 y=6 


MSVC 


MSVC's implementation (2012) is just the same, but it also stores the current size of 
the list. 


This implies that the .size() method is very fast (O(1)): it just reads one value from 
memory. 


On the other hand, the size variable must be updated at each insertion/deletion. 


MSVC's implementation is also slightly different in the way it arranges the nodes: 


list.begin() 


Variable 
std::list 


CENE 
X=garbage 


Y=garbage 


> J 


Ho 
X=2nd ele- 
men 


Y=2nd ele- 


ment2nd élé- 
ment 


GCC has its dummy element at the end of the list, while MSVC's is at the beginning. 
Listing 3.114: Optimizing MSVC 2012 /Fa2.asm /GS- /Ob1 


l$ = -16 ; size 8 
_t1$ = -8 ; size 8 
main PROC 
sub esp, 16 
push ebx 
push esi 
push edi 
push 0 
push 0 
lea ecx, DWORD PTR _1$[esp+36] 
mov DWORD PTR _l$[esp+40], 0 
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; allocate first garbage element 

call ? BuynodeQ@?$ List allocQ$0AQU?$ List base types@Ua@@V? /” 
y $allocator@Ua@@@s td@@@std@@@std@@QAEPAU? 7 

S $_List_node@Ua@@PAX@2@PAU32@0@Z ; 


std:: List alloc«0,std:: List base types<a,std::allocator<a> > »:: 


mov edi, DWORD PTR imp printf 

mov ebx, eax 

push OFFSET $SG40685 ; '* empty list:' 

mov DWORD PTR _l$[esp+32], ebx 

call edi ; printf 

lea eax, DWORD PTR _1$[esp+32] 

push eax 

call ?dump List _val@@YAXPAI@Z ; dump List val 

mov esi, DWORD PTR [ebx] 

add esp, 8 

lea eax, DWORD PTR _t1$[esp+28] 

push eax 

push DWORD PTR [esi+4] 

lea ecx, DWORD PTR _1$[esp+36] 

push esi 

mov DWORD PTR tl$[esp+40], 1 ; data for a new node 
mov DWORD PTR ti$[esp+44], 2 ; data for a new node 
; allocate new node 

call ??$ Buynode@ABUa@@@?$ List buyQUaQgQV? 7 

y $allocator@Ua@@@s td@@@std@@QAEPAU? ^ 

S $_List_node@Ua@@PAX@1@PAU21@0ABUa@@@Z ; 

std:: List buy«a,std::allocator«a» »:: Buynode<a const &» 
mov DWORD PTR [esi+4], eax 

mov ecx, DWORD PTR [eax+4] 

mov DWORD PTR ti$[esp+28], 3 ; data for a new node 
mov DWORD PTR [ecx], eax 

mov esi, DWORD PTR [ebx] 

lea eax, DWORD PTR _t1$[esp+28] 

push eax 

push DWORD PTR [esi+4] 

lea ecx, DWORD PTR _1$[esp+36] 

push esi 

mov DWORD PTR ti$[esp+44], 4 ; data for a new node 
; allocate new node 

call ??$ Buynode@ABUa@@e@?$ List _buy@Ua@e@V? 7 

y $allocator@Ua@@@s td@@@stda@@QAEPAU? 7 

S $_List_node@Ua@@PAX@1@PAU21@0ABUa@@@Z ; 

std:: List buy«a,std::allocator«a» »:: Buynode<a const &» 
mov DWORD PTR [esi+4], eax 

mov ecx, DWORD PTR [eax+4] 

mov DWORD PTR tl$[esp+28], 5 ; data for a new node 
mov DWORD PTR [ecx], eax 

lea eax, DWORD PTR _t1$[esp+28] 

push eax 

push DWORD PTR [ebx+4] 

lea ecx, DWORD PTR _1$[esp+36] 

push ebx 

mov DWORD PTR tl$[esp+44], 6 ; data for a new node 
; allocate new node 


Buynode 
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call ??$ Buynode@ABUa@@@?$ List buyQUaQgQV? 7 

y $allocator@Ua@@@s td@@@st d@@QAEPAU? 7 

V $_List_node@Ua@@PAX@1@PAU21@0ABUa@@@Z ; 

std:: List buy«a,std::allocator«a» »:: Buynode<a const &> 
mov DWORD PTR [ebx+4], eax 

mov ecx, DWORD PTR [eax+4] 

push OFFSET $SG40689 ; '* 3-elements List:' 

mov DWORD PTR 1$[esp+361, 3 

mov DWORD PTR [ecx], eax 

call edi ; printf 

lea eax, DWORD PTR _1$[esp+32] 

push eax 

call ?dump List val@@YAXPAI@Z ; dump List val 

push OFFSET $SG40831 ; ‘node at .begin:' 

call edi ; printf 

push DWORD PTR [ebx] ; get next field of node "l" variable points to 
call ?dump List node@@YAXPAUList node@@@Z ; dump List node 
push OFFSET $5G40835 ; ‘node at .end:' 

call edi ; printf 

push ebx ; pointer to the node "l" variable points to! 
call ?dump List node@@YAXPAUList node@@@Z ; dump List node 
push OFFSET $5G40839 ; '* let''s count from the begin: ' 
call edi ; printf 

mov esi, DWORD PTR [ebx] ; operator++: get ->next pointer 
push DWORD PTR [esi+12] 

push DWORD PTR [esi+8] 

push OFFSET $SG40846 ; ‘list element: %d %d' 

call edi ; printf 

mov esi, DWORD PTR [esi] ; operator++: get ->next pointer 
push DWORD PTR [esi+12] 

push DWORD PTR [esi+8] 

push OFFSET $SG40848 ; ‘2nd element: %d %d' 

call edi ; printf 

mov esi, DWORD PTR [esi] ; operator++: get ->next pointer 
push DWORD PTR [esi+12] 

push DWORD PTR [esi+8] 

push OFFSET $SG40850 ; ‘3rd element: %d %d' 

call edi ; printf 

mov eax, DWORD PTR [esi] ; operator++: get ->next pointer 
add esp, 64 

push DWORD PTR [eax+12] 

push DWORD PTR [eax+8] 

push OFFSET $SG40852 ; ‘element at .end(): %d %d' 

call edi ; printf 

push OFFSET $SG40853 ; '* let''s count from the end:' 

call edi ; printf 

push DWORD PTR [ebx+12] ; use x and y fields from the node "l" variable 
points to 

push DWORD PTR [ebx+8] 

push OFFSET $SG40860 ; ‘element at .end(): %d %d' 

call edi ; printf 

mov esi, DWORD PTR [ebx+4] ; operator--: get ->prev pointer 
push DWORD PTR [esi+12] 

push DWORD PTR [esi+8] 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


726 


push OFFSET $SG40862 ; '3rd element: %d %d' 

call edi ; printf 

mov esi, DWORD PTR [esi+4] ; operator--: get ->prev pointer 
push DWORD PTR [esi+12] 

push DWORD PTR [esi+8] 

push OFFSET $SG40864 ; '2nd element: %d %d' 

call edi ; printf 

mov eax, DWORD PTR [esi+4] ; operator--: get ->prev pointer 
push DWORD PTR [eax+12] 

push DWORD PTR [eax+8] 

push OFFSET $SG40866 ; ‘lst element: %d %d' 

call edi ; printf 

add esp, 64 

push OFFSET $SG40867 ; ‘removing last element...' 

call edi ; printf 

mov edx, DWORD PTR [ebx+4] 

add esp, 4 


; prev=next? 

; it is the only element, garbage one? 
; if yes, do not delete it! 

cmp edx, ebx 

je SHORT $LN349@main 

mov ecx, DWORD PTR [edx+4] 

mov eax, DWORD PTR [edx] 

mov DWORD PTR [ecx], eax 

mov ecx, DWORD PTR [edx] 

mov eax, DWORD PTR [edx+4] 

push edx 

mov DWORD PTR [ecx+4], eax 

call ??3@YAXPAX@Z ; operator delete 


add esp, 4 

mov DWORD PTR _1l$[esp+32], 2 
$LN349@main: 

lea eax, DWORD PTR _1$[esp+28] 

push eax 


call ?dump List_val@@YAXPAI@Z ; dump List val 
mov eax, DWORD PTR [ebx] 

add esp, 4 

mov DWORD PTR [ebx], ebx 

mov DWORD PTR [ebx+4], ebx 

cmp eax, ebx 

je SHORT $LN412@main 


$LL414@main: 
mov esi, DWORD PTR [eax] 
push eax 
call ??3@YAXPAX@Z ; operator delete 
add esp, 4 


mov eax, esi 

cmp esi, ebx 

jne SHORT $LL414@main 
$LN412@main: 

push ebx 
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call ??3@YAXPAX@Z ; operator delete 


add esp, 4 
xor eax, eax 
pop edi 
pop esi 
pop  ebx 
add esp, 16 
ret 0 

main ENDP 


Unlike GCC, MSVC's code allocates the dummy element at the start of the function 
with the help of the "Buynode" function, it is also used to allocate the rest of the 
nodes ( GCC's code allocates the first element in the local stack). 


Listing 3.115: The whole output 


* empty list: 

_Myhead=0x003CC258, _Mysize=0 

ptr=0x003CC258 Next=0x003CC258 Prev=0x003CC258 x=6226002 y=4522072 
* 3-elements list: 

_Myhead=0x003CC258, Mysize=3 

ptr=0x003CC258 Next=0x003CC288 _Prev=0x003CC2A0 x=6226002 y=4522072 


ptr=0x003CC288 Next=0x003CC270 Prev=Qx003CC258 x=3 y=4 
ptr=0x003CC270  Next-0x003CC2A0 _Prev=0x003CC288 x=1 y=2 
ptr=0x003CC2A0  Next-0x003CC258 _Prev=0x003CC270 x=5 y=6 


node at .begin: 

ptr=0x003CC288 Next=0x003CC270 Prev=0x003CC258 x=3 y=4 

node at .end: 

ptr=0x003CC258 Next=0x003CC288 _Prev=0x003CC2A0 x=6226002 y=4522072 
* let's count from the beginning: 

lst element: 3 4 

2nd element: 1 2 

3rd element: 5 6 

element at .end(): 6226002 4522072 

* let's count from the end: 

element at .end(): 6226002 4522072 

3rd element: 5 6 

2nd element: 1 2 

lst element: 3 4 

removing last element... 

_Myhead=0x003CC258, _Mysize=2 

ptr=0x003CC258  Next-0x003CC288 _Prev=0x003CC270 x=6226002 y=4522072 
ptr=0x003CC288  Next-0x003CC270 Prev=0x003CC258 x=3 y=4 
ptr=0x003CC270  Next-0x003CC258 _Prev=0x003CC288 x=1 y=2 


C++11 std::forward list 


The same thing as std::list, but singly-linked one, i.e., having only the "next" field at 
each node. 


It has a smaller memory footprint, but also don't offer the ability to traverse list 
backwards. 
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std::vector 


We would call std::vector a safe wrapper of the PODT?! C array. Internally it is 
somewhat similar to std::string (3.21.4 on page 706): it has a pointer to the 
allocated buffer, a pointer to the end of the array, and a pointer to the end of the 
allocated buffer. 


The array's elements lie in memory adjacently to each other, just like in a normal 
array (1.26 on page 330). In C++11 there is a new method called .data() , that 
returns a pointer to the buffer, like .c str() in std::string. 


The buffer allocated in the heap can be larger than the array itself. 


Both MSVC's and GCC's implementations are similar, just the names of the struc- 
ture's fields are slightly different??, so here is one source code that works for both 
compilers. Here is again the C-like code for dumping the structure of std: : vector: 


#include <stdio.h> 
#include <vector> 
#include <algorithm> 
#include <functional> 


struct vector of ints 


1 
// MSVC names: 
int *Myfirst; 
int *Mylast; 
int *Myend; 
// GCC structure is the same, but names are: 
M start, M finish, M end of storage 
$; 
void dump(struct vector of ints *in) 
1 
printf (" Myfirst-*p, Mylast=%p, Myend=%p\n", in->Myfirst, in->Mylastv 
S , in->Myend) ; 
size t size=(in->Mylast-in->Myfirst) ; 
size t capacity=(in->Myend-in->Myfirst) ; 
printf ("size-*d, capacity=%d\n", size, capacity); 
for (size t i=0; i<size; i++) 
printf ("element %d: %d\n", i, in->Myfirst[i]); 
$; 
int main() 
1 


std::vector<int> c; 

dump ((struct vector of ints*)(void*)&c); 
c.push back(1); 

dump ((struct vector of ints*)(void*)&c); 
c.push back(2); 


31(C++) Plain Old Data Type 
32GCC internals: http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-4.4/ 
a01371.html 
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dump ((struct vector of ints*)(void*)&c); 
c.push back(3); 

dump ((struct vector of ints*)(void*)&c); 
c.push back(4); 

dump ((struct vector of ints*)(void*)&c); 
c.reserve (6); 

dump ((struct vector of ints*)(void*)&c); 
c.push back(5); 

dump ((struct vector of ints*)(void*)&c); 
c.push back(6); 

dump ((struct vector of ints*)(void*)&c); 


printf ("%d\n", c.at(5)); // with bounds checking 
printf ("%d\n", c[8]); // operator[], without bounds checking 


Fi 


Here is the output of this program when compiled in MSVC: 


_Myfirst=00000000, _Mylast=00000000, _Myend=00000000 


size=0, 


capacity=0 


 Myfirst-0051CF48, Mylast=0051CF4C, Myend=0051CF4C 


size=1, 
element 


capacity=1 
0: 1 


_Myfirst=0051CF58, Mylast=0051CF60, Myend=0051CF60 


size-2, 
element 
element 


capacity-2 
0: 1 
1: 2 


 Myfirst-0051C278, Mylast-0051C284, Myend-0051C284 


size-3, 
element 
element 
element 


capacity-3 
0: 1 
1: 2 
2: 3 


 Myfirst-0051C290, Mylast-0051C2A0, Myend-0051C2A0 


size-4, 
element 
element 
element 
element 


capacity-4 
0: 1 
1: 2 
2: 3 
3: 4 


 Myfirst-0051B180, Mylast=0051B190, Myend-0051B198 


size-4, 
element 
element 
element 
element 


capacity=6 
0: 1 
1: 2 
2: 3 
3: 4 


 Myfirst-0051B180, Mylast=0051B194, Myend-0051B198 


size-5, 
element 
element 
element 
element 
element 


capacity=6 
0: 1 

1: 2 
2* 3 
3: 4 
4:5 


 Myfirst-0051B180, Mylast=0051B198, Myend-0051B198 


size-6, 
element 
element 


capacity=6 
0: 1 
1: 2 
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element 2: 
element 3: 
element 4: 
element 5: 
6 

6619158 


Au U 


As it can be seen, there is no allocated buffer when main() starts. After the first 
push back() call, a buffer is allocated. And then, after each push back() call, both 
array size and buffer size (capacity) are increased. But the buffer address changes 
as well, because push back() reallocates the buffer in the heap each time. It is 
costly operation, that's why it is very important to predict the size of the array in the 
future and reserve enough space for it with the . reserve() method. 


The last number is garbage: there are no array elements at this point, so a random 
number is printed. This illustrates the fact that operator[] of std::vector does 
not check of the index is in the array's bounds. The slower .at() method, however, 
does this checking and throws an std::out of range exception in case of error. 


Let's see the code: 


Listing 3.116: MSVC 2012 /GS- /Ob1 


$5G52650 DB '% 
$SG52651 DB '% 


d', OaH, 00H 
d', OaH, OOH 
_this$ -4 ; size 4 
__Pos$ = 8 ; size = 4 
Pata@?$vector@HV?$allocator@H@std@@a@std@@QAEAAHI@Z PROC ; 
std: :vector<int,std::allocator<int> >::at, COMDAT 
; this$ = ecx 
push ebp 
mov ebp, esp 
push ecx 
mov DWORD PTR this$[ebp], ecx 
mov eax, DWORD PTR _this$[ebp] 
mov ecx, DWORD PTR _this$[ebp] 
mov edx, DWORD PTR [eax+4] 
sub edx, DWORD PTR [ecx] 
sar edx, 2 
cmp edx, DWORD PTR  Pos$[ebp] 
ja SHORT $LN1@at 
push OFFSET ?? C@ OBMQNMJKDPPOQinvalid?5vector?$DMT?$DO?5subscript?$AAQ 
call DWORD PTR imp ? Xout of range@std@@YAXPBD@Z 
$LN1Gat : 
mov eax, DWORD PTR this$[ebp] 
mov ecx, DWORD PTR [eax] 
mov edx, DWORD PTR _ Pos$[ebp] 
lea eax, DWORD PTR [ecx+edx*4] 
$LN3@at : 
mov esp, ebp 
pop ebp 
ret 4 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


731 


2ate@?$vector@HV?$allocator@H@std@@a@std@@QAEAAHI@Z ENDP ; 


_c$ 
$T1 


std: :vector<int,std::allocator<int> >::at 


N 


-36 ; size 
-24 ; size 
; size 
; size 
-12 ; size 
; size 
; size 


Hon g n m n 
1 
an 
(o>) 


E ESSE 


sub esp, 36 

mov DWORD PTR c$[ebp], 0 ; Myfirst 

mov DWORD PTR c$[ebp+4], 0 ; Mylast 

mov DWORD PTR c$[ebp+8], 0 ; Myend 

lea eax, DWORD PTR _c$[ebp] 

push eax 

call ?dump@@YAXPAUvector_of_ints@@@Z ; dump 

add esp, 4 

mov DWORD PTR $T6[ebp], 1 

lea ecx, DWORD PTR $T6[ebp] 

push ecx 

lea ecx, DWORD PTR c$[ebp] 

call ?push backQ?$vectorgHV?$allocatorgHastd(eeestdagQAEX$$QAHQGZ ; 
std::vector«int,std::allocator«int» >::push back 
lea edx, DWORD PTR c$[ebp] 

push edx 

call ?dump@@YAXPAUvector_of_ints@@@Z ; dump 

add esp, 4 

mov DWORD PTR $T5[ebp], 2 

lea eax, DWORD PTR $T5[ebp] 

push eax 

lea ecx, DWORD PTR _c$[ebp] 

call ?push_back@?$vector@HV?$al locator@H@std@@@std@@QAEX$$QAH@Z ; 
std: :vector<int,std::allocator<int> >::push back 
lea ecx, DWORD PTR _c$[ebp] 

push ecx 

call ?dump@@YAXPAUvector_of_ints@@@Z ; dump 

add esp, 4 

mov DWORD PTR $T4[ebp], 3 

lea edx, DWORD PTR $T4[ebp] 

push edx 

lea ecx, DWORD PTR _c$[ebp] 

call ?push_back@?$vector@HV?$allocator@H@std@@@std@@QAEX$$QAH@Z ; 
std: :vector<int,std::allocator<int> >::push back 
lea eax, DWORD PTR _c$[ebp] 

push eax 

call ?dump@@YAXPAUvector_of_ints@@@Z ; dump 

add esp, 4 

mov DWORD PTR $T3[ebp], 4 

lea ecx, DWORD PTR $T3[ebp] 

push ecx 
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lea 
call 
std:: 
lea 
push 
call 
add 
push 
lea 
call 
std: 
lea 


push 
call 
add 
mov 
lea 
push 
lea 
call 
std: 
lea 
push 
call 
add 
mov 
lea 
push 
lea 
call 
std: 
lea 
push 
call 
add 


ecx, DWORD PTR  c$[ebp] 

?push_back@?$vector@HV?$al lLocator@H@std@@@std@@QAEX$$QAH@Z ; 
vector<int,std::allocator<int> >::push back 

edx, DWORD PTR c$[ebp] 

edx 

?dump@@YAXPAUvector of ints@@@Z ; dump 

esp, 4 

6 

ecx, DWORD PTR c$[ebp] 
?reserve@?$vector@HV?$allocator@H@std@@a@std@@QAEXI@Z ; 


:vector<int,std::allocator<int> >::reserve 


eax, DWORD PTR _c$[ebp] 

eax 

?dump@@YAXPAUvector of ints@@@Z ; dump 

esp, 4 

DWORD PTR $T2[ebp], 5 

ecx, DWORD PTR $T2[ebp] 

ecx 

ecx, DWORD PTR  c$[ebp] 

?push_back@?$vector@HV?$al Locator@H@std@@@std@@QAEX$$QAH@Z ; 


:vector<int,std::allocator<int> >::push back 


edx, DWORD PTR _c$[ebp] 

edx 

?dump@@YAXPAUvector of ints@@@Z ; dump 

esp, 4 

DWORD PTR $T1[ebp], 6 

eax, DWORD PTR $T1[ebp] 

eax 

ecx, DWORD PTR _c$[ebp] 

?push_back@?$vector@HV?$al Locator@H@std@@@std@@QAEX$$QAH@Z ; 


:vector<int,std::allocator<int> >::push back 


ecx, DWORD PTR _c$[ebp] 

ecx 

?dump@@YAXPAUvector of ints@@@Z ; dump 
esp, 4 


push 5 


lea 
call 
std: 
mov 
push 
push 
call 
add 
mov 
shl 
mov 
mov 
push 
push 
call 
add 
lea 
call 
std:: 


ecx, DWORD PTR  c$[ebp] 
?ate@?$vector@HV?$allocator@H@std@@@std@@QAEAAHI@Z ; 


:vector<int,std::allocator<int> >::at 


edx, DWORD PTR [eax] 

edx 

OFFSET $SG52650 ; '%d' 

DWORD PTR imp printf 

esp, 8 

eax, 8 

eax, 2 

ecx, DWORD PTR _c$[ebp] 

edx, DWORD PTR [ecx+eax] 

edx 

OFFSET $SG52651 ; '%d' 

DWORD PTR _imp_ printf 

esp, 8 

ecx, DWORD PTR _c$[ebp] 

? Tidy@?$vector@HV?$allocator@H@std@@@std@@IAEXXZ ; 
vector<int,std::allocator<int> >:: Tidy 
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xor eax, eax 
mov esp, ebp 


pop ebp 
ret 0 
main ENDP 


We see how the .at() method checks the bounds and throws an exception in case 
of error. The number that the last printf() call prints is just taken from the memory, 
without any checks. 


One may ask, why not use the variables like "size" and "capacity", like it was done 
in std::string. Supposedly, this was done for faster bounds checking. 


The code GCC generates is in general almost the same, but the .at() method is 
inlined: 


Listing 3.117: GCC 4.8.1 -fno-inline-small-functions -O1 


main proc near 

push ebp 
mov ebp, esp 
push edi 
push esi 
push ebx 
and esp, OFFFFFFFOh 
sub esp, 20h 
mov dword ptr [esp+14h], 0 
mov dword ptr [esp+18h], 0 
mov dword ptr [esp+1Ch], 0 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov dword ptr [esp+10h], 1 
lea eax, [esp+10h] 
mov [esp+4], eax 
lea eax, [esp+14h] 
mov [esp], eax 
call ZNSt6vectorliSaliEE9push backERKi ; 

std: :vector<int,std::allocator<int>>::push back(int  const&) 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov dword ptr [esp+10h], 2 
lea eax, [esp+10h] 
mov [esp+4], eax 
lea eax, [esp+14h] 
mov [esp], eax 
call ZNSt6vectorliSaliEE9push backERKi ; 

std: :vector<int,std::allocator<int>>: :push back(int  const&) 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov dword ptr [esp+10h], 3 
lea eax, [esp+10h] 
mov [esp+4], eax 
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lea eax, [esp+14h] 
mov [esp], eax 
call ZNSt6vectorliSaliEE9push backERKi ; 
std: :vector<int,std::allocator<int>>::push_back(int  const&) 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov dword ptr [esp+10h], 4 
lea eax, [esp+10h] 
mov [esp+4], eax 
lea eax, [esp+14h] 
mov [esp], eax 
call ZNSt6vectorliSaliEE9push backERKi ; 
std: :vector<int,std::allocator<int>>::push_back(int const&) 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov ebx, [esp+14h] 
mov eax, [esp+1Ch] 
sub eax, ebx 
cmp eax, 17h 
ja short loc 80001CF 
mov edi, [esp+18h] 
sub edi, ebx 
sar edi, 2 
mov dword ptr [esp], 18h 
call Znwj ; operator new(uint) 
mov esi, eax 
test edi, edi 
jz short loc 80001AD 
lea eax, ds:0[edi*4] 


mov [esp+8], eax ; n 
mov [esp+4], ebx ; src 
mov [esp], esi ; dest 


call memmove 


loc 80001AD: ; CODE XREF: main+F8 
mov eax, [esp+14h] 
test eax, eax 
jz short loc 80001BD 
mov [esp], eax ; void * 
call ZdlPv ; operator delete(void *) 


loc 80001BD: ; CODE XREF: main+117 
mov [esp+14h], esi 
lea eax, [esi+edi*4] 
mov [esp+18h], eax 
add esi, 18h 
mov [esp+1Ch], esi 


loc 80001CF: ; CODE XREF: main+DD 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
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mov dword ptr [esp+10h], 5 
lea eax, [esp+10h] 
mov [esp+4], eax 
lea eax, [esp+14h] 
mov [esp], eax 
call ZNSt6vectorliSaliEE9push backERKi ; 
std: :vector<int,std::allocator<int>>::push_back(int  const&) 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov dword ptr [esp+10h], 6 
lea eax, [esp+10h] 
mov [esp+4], eax 
lea eax, [esp+14h] 
mov [esp], eax 
call ZNSt6vectorliSaliEE9push backERKi ; 
std: :vector<int,std::allocator<int>>::push_back(int  const&) 
lea eax, [esp+14h] 
mov [esp], eax 
call Z4dumpPl4vector of ints ; dump(vector of ints *) 
mov eax, [esp+14h] 
mov edx, [esp+18h] 
sub edx, eax 
cmp edx, 17h 
ja short loc 8000246 


mov dword ptr [esp], offset aVector m range ; "vector:: M range check" 
call ZSt20 throw out of rangePKc ; 
std:: throw out of range(char const*) 
loc 8000246: ; CODE XREF: main+19C 


mov eax, [eax+14h] 

mov [esp+8], eax 

mov dword ptr [esp+4], offset aD ; "%d\n" 
mov dword ptr [esp], 1 

call  printf chk 

mov eax, [esp+14h] 

mov eax, [eax+20h] 

mov [esp+8], eax 

mov dword ptr [esp+4], offset aD ; "%d\n" 
mov dword ptr [esp], 1 

call  printf chk 

mov eax, [esp+14h] 

test eax, eax 

jz short loc 80002AC 

mov [esp], eax ; void * 

call ZdlPv ; operator delete(void *) 
jmp short loc 80002AC 


mov ebx, eax 

mov edx, [esp+14h] 

test edx, edx 

jz short loc 80002A4 

mov [esp], edx ; void * 

call ZdlPv ; operator delete(void *) 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


736 


loc 80002A4: ; CODE XREF: main+1FE 
mov [esp], ebx 
call Unwind Resume 


loc 80002AC: ; CODE XREF: main+1EA 

; main+1F4 

mov eax, 0 

lea esp, [ebp-0Ch] 

pop ebx 

pop esi 

pop edi 

pop ebp 


locret 80002B8: ; DATA XREF: .eh frame:08000510 
; .eh frame:080005BC 
retn 
main endp 


.Feserve() is inlined as well. It calls new() if the buffer is too small for the new size, 
calls memmove() to copy the contents of the buffer, and calls delete() to free the 
old buffer. 


Let's also see what the compiled program outputs if compiled with GCC: 


_Myfirst=0x(nil), _Mylast=0x(nil), _Myend=0x(nil) 
size-0, capacity-0 

_Myfirst=0x8257008, _Mylast=0x825700c, _Myend=0x825700c 
size-1, capacity=1 

element 0: 1 

_Myfirst=0x8257018, Mylast=0x8257020, Myend=0x8257020 
size=2, capacity=2 

element 0: 1 

element 1: 2 

_Myfirst=0x8257028, _Mylast=0x8257034, Myend=0x8257038 
size=3, capacity=4 

element 0: 1 

element 1: 2 

element 2: 3 

_Myfirst=0x8257028, _Mylast=0x8257038, Myend=0x8257038 
size=4, capacity=4 

element 0: 1 

element 1: 2 

element 2: 3 

element 3: 4 

_Myfirst=0x8257040, Mylast=0x8257050, _Myend=0x8257058 
size=4, capacity=6 

element 0: 1 

element 1: 2 

element 2: 3 

element 3: 4 

_Myfirst=0x8257040, Mylast=0x8257054, _Myend=0x8257058 
size=5, capacity=6 
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element 0: 1 
element 1: 2 
element 2: 3 
element 3: 4 


element 4: 5 

_Myfirst=0x8257040, Mylast=0x8257058, _Myend=0x8257058 
size=6, capacity=6 

element 
element 
element 
element 
element 
element 
6 

0 


UBWNF © 
O) Ul «3 UJ NJ HÀ 


We can spot that the buffer size grows in a different way that in MSVC. 


Simple experimentation shows that in MSVC's implementation the buffer grows by 
~50% each time it needs to be enlarged, while GCC's code enlarges it by 10096 each 
time, i.e., doubles it. 


std::map and std::set 


The binary tree is another fundamental data structure. 


As its name states, this is a tree where each node has at most 2 links to other nodes. 
Each node has key and/or value: std: :set provides only key at each node, std: :map 
provides both key and value at each node. 


Binary trees are usually the structure used in the implementation of "dictionaries" 
of key-values (AKA "associative arrays"). 


There are at least three important properties that a binary trees has: 
* All keys are always stored in sorted form. 


* Keys of any types can be stored easily. Binary tree algorithms are unaware of 
the key's type, only a key comparison function is required. 


* Finding a specific key is relatively fast in comparison with lists and arrays. 


Here is a very simple example: let's store these numbers in a binary tree: O, 1, 2, 3, 
5, 6, 9, 10, 11, 12, 20, 99, 100, 101, 107, 1001, 1010. 
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All keys that are smaller than the node key's value are stored on the left side. 
All keys that are bigger than the node key's value are stored on the right side. 


Hence, the lookup algorithm is straightforward: if the value that you are looking for 
is smaller than the current node's key value: move left, if it is bigger: move right, 
stop if the value required is equal to the node key's value. 


That is why the searching algorithm may search for numbers, text strings, etc., as 
long as a key comparison function is provided. 


All keys have unique values. 


Having that, one needs s log, n steps in order to find a key in a balanced binary tree 
with n keys. This implies that « 10 steps are needed « 1000 keys, or « 13 steps for 
x 10000 keys. 


Not bad, but the tree has always to be balanced for this: i.e., the keys has to be 
distributed evenly on all levels. The insertion and removal operations do some main- 
tenance to keep the tree in a balanced state. 


There are several popular balancing algorithms available, including the AVL tree and 
the red-black tree. 


The latter extends each node with a "color" value to simplify the balancing process, 
hence, each node may be "red" or "black". 


Both GCC's and MSVC's std: :map and std: :set template implementations use red- 
black trees. 


std::set has only keys. std: :map is the "extended" version of std::set: it also has 
a value at each node. 


MSVC 


#include «map» 
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#include «set» 
#include <string> 
#include <iostream> 


// Structure is not packed! Each field occupies 4 bytes. 
struct tree node 


1 
struct tree node *Left; 
struct tree node *Parent; 
struct tree node *Right; 
char Color; // 0 - Red, 1 - Black 
char Isnil; 
//std::pair Myval; 
unsigned int first; // called Myval in std::set 
const char *second; // not present in std::set 
$; 
struct tree struct 
1 
struct tree node *Myhead; 
size t Mysize; 
$; 


void dump tree node (struct tree node *n, bool is set, bool traverse) 
1 
printf ("ptr=0x%p Left=0x%p Parent=0x%p Right=0x%p Color=%d Isnil-*sdWAn"7 
Y, 
n, n->Left, n->Parent, n->Right, n->Color, n->Isnil); 
if (n->Isnil==0) 


{ 
if (is set) 
printf ("first=%d\n", n->first); 
else 
printf ("first=%d second=[%s]\n", n->first, n->second); 
} 
if (traverse) 
{ 
if (n->Isnil==1) 
dump_tree_node (n->Parent, is_set, true); 
else 
{ 
if (n->Left->Isnil==0) 
dump_tree_node (n->Left, is_set, true); 
if (n->Right->Isnil==0) 
dump_tree_node (n->Right, is_set, true); 
}; 
}; 


yi 
const char* ALOT OF TABS="\t\t\t\t\t\t\t\t\t\t\t"; 


void dump as tree (int tabs, struct tree node *n, bool is set) 
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1 
if (is set) 
printf ("%d\n", n->first); 
else 
printf ("sd [%s]\n", n->first, n->second); 
if (n->Left->Isnil==0) 
1 
printf ("%.*sL------- ", tabs, ALOT OF _TABS); 
dump as tree (tabs+1, n->Left, is set); 
$; 
if (n->Right->Isnil==0) 
1 
printf ("%.*SR------- ", tabs, ALOT OF TABS) ; 
dump as tree (tabs+1, n->Right, is set); 
$; 
$; 
void dump map and set(struct tree struct *m, bool is set) 
1 
printf ("ptr=0x%p, Myhead=0x%p, Mysize=%d\n", m, m->Myhead, m->Mysize) ; 
dump tree node (m->Myhead, is set, true); 
printf ("As a tree:\n"); 
printf ("root----"); 
dump as tree (1, m->Myhead->Parent, is set); 
$; 
int main() 
1 


// map 


std::map<int, const char*» m; 


m[10]="ten"; 
m[20]="twenty"; 
m[3]="three"; 


m[101]2"one hundred one"; 
m[100]2"one hundred"; 
m[12]2"twelve"; 

m[107]="one hundred seven"; 
m[0]="zero"; 

m[1]="one"; 

m[6]="six"; 
m[99]="ninety-nine"; 
m[5]="five"; 

m[11]="eleven"; 

m[1001]2"one thousand one"; 
m[1010]2"one thousand ten"; 
m[2]2"two"; 

m[9]2"nine"; 

printf ("dumping m as map: n"); 
dump map and set ((struct tree struct *)(void*)&m, false); 


std::map<int, const char*>::iterator itl=m.begin(); 
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printf ("m.begin():\n"); 


dump tree node ((struct tree node *)*(void**)&itl, false, false); 


itl=m.end(); 
printf ("m.end():\n"); 


dump tree node ((struct tree node *)*(void**)&itl, false, false); 


// set 


std::set<int> s; 
.insert(123); 

.insert(456); 

.insert(11); 
.insert(12); 
.insert(100); 
s.insert(1001); 


Nnnnnn 


printf ("dumping s as set:\n"); 
dump map and set ((struct tree struct *)(void*)&s, true); 
std::set«int»::iterator it2-s.begin(); 


printf ("s.begin():\n"); 


dump tree node ((struct tree node *)*(void**)&it2, true, false); 


it2=s.end(); 
printf ("s.end():\n"); 


dump tree node ((struct tree node *)*(void**)&it2, true, false); 


r 


Listing 3.118: MSVC 2012 


dumping m as map: 


ptr=0x0020FE04, Myhead=0x005BB3A0, Mysize=17 


ptr=0x005BB3A0 Left=0x005BB4A0 
S Isnil=1 

ptr=0x005BB3C0 Left=0x005BB4C0 
y Isnil=0 

first=10 second=[ten] 

ptr=0x005BB4C0 Left=0x005BB4A0 
S Isnil=0 

first=1 second=[one] 

ptr=0x005BB4A0 Left=0x005BB3A0 
4 Isnil=0 

first=0 second=[zero] 

ptr=0x005BB520 Left=0x005BB400 
S Isnil=0 

first=5 second=[five] 

ptr=0x005BB400 Left=0x005BB5A0 
4 Isnil=0 

first=3 second=[three] 

ptr=0x005BB5A0 Left=0x005BB3A0 
S Isnil=0 

first=2 second=[two] 

ptr=0x005BB4E0 Left=0x005BB3A0 
4 Isnil=0 

first=6 second=[six] 

ptr=0x005BB5C0 Left=0x005BB3A0 
S Isnil=0 


Parent=0x005BB3C0 


Parent=0x005BB3A0 


Parent=0x005BB3C0 


Parent=0x005BB4C0 


Parent=0x005BB4C0 


Parent=0x005BB520 


Parent=0x005BB400 


Parent=0x005BB520 


Parent=0x005BB4E0 


Right=0x005BB580 


Right=0x005BB440 


Right=0x005BB520 


Right=0x005BB3A0 


Right=0x005BB4E0 


Right=0x005BB3A0 


Right=0x005BB3A0 


Right=0x005BB5C0 


Right=0x005BB3A0 


Color=1 


Color=1 


Color=1 


Color=1 


Color=0 


Color=1 


Color=0 


Color=1 


Color=0 
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first=9 second=[nine] 

ptr=0x005BB440 Left=0x005BB3E0 Parent=0x005BB3C0 Right=0x005BB480 Color-1 7 
y Isnil=0 

first=100 second=[one hundred] 

ptr=0x005BB3E0 Left=0x005BB460 Parent=0x005BB440 Right=0x005BB500 Color=0 2 
y Isnil=0 

first=20 second=[twenty] 

ptr=0x005BB460 Left=0x005BB540 Parent=0x005BB3E0 Right=0x005BB3A0 Color=1 7 
y Isnil=0 

first=12 second=[twelve] 

ptr=0x005BB540 Left=0x005BB3A0 Parent=0x005BB460 Right=0x005BB3A0 Color=0 7 
y Isnil=0 

first=11 second=[eleven] 

ptr=0x005BB500 Left=0x005BB3A0 Parent=0x005BB3E0 Right=0x005BB3A0 Color=1 7 
y Isnil=0 

first=99 second=[ninety-nine] 

ptr=0x005BB480 Left=0x005BB420 Parent=0x005BB440 Right=0x005BB560 Color=0 7 
4 Isnil=0 

first=107 second=[one hundred seven] 

ptr=0x005BB420 Left=0x005BB3A0 Parent=0x005BB480 Right=0x005BB3A0 Color=1 7 
y Isnil=0 

first=101 second=[one hundred one] 

ptr=0x005BB560 Left=0x005BB3A0 Parent=0x005BB480 Right=0x005BB580 Color=1 7 
y Isnil=0 

first=1001 second=[one thousand one] 

ptr=0x005BB580 Left=0x005BB3A0 Parent=0x005BB560 Right=0x005BB3A0 Color=0 7 


& Isnil=0 
first=1010 second=[one thousand ten] 
As a tree: 
root----10 [ten] 
L------- 1 [one] 
L------- 0 [zero] 
R------- 5 [five] 
L------- 3 [three] 
L------- 2 [two] 
R------- 6 [six] 
R------- 9 [nine] 
R------- 100 [one hundred] 
L------- 20 [twenty] 
L------- 12 [twelve] 
L------- 11 [eleven] 
R------- 99 [ninety-nine] 
R------- 107 [one hundred seven] 
L------- 101 [one hundred one] 
R------- 1001 [one thousand one] 
R------- 1010 [one thousand ten] 
m.begin(): 
ptr=0x005BB4A0 Left=0x005BB3A0 Parent=0x005BB4C0 Right=0x005BB3A0 Color-1 7 
S Isnil=0 
first=0 second=[zero] 
m.end(): 
ptr=0x005BB3A0 Left=0x005BB4A0 Parent=0x005BB3C0 Right=0x005BB580 Color-1 7 
S Isnil=1 
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dumping s as set: 
ptr=0x0020FDFC, Myhead=0x005BB5E0, Mysize=6 
ptr=0x005BB5E0 Left=0x005BB640 Parent=0x005BB600 Right=0x005BB6A0 Color=1 7 


S Isnil=1 
ptr=0x005BB600 Left=0x005BB660 Parent=0x005BB5E0 Right=0x005BB620 Color=1 7 
y Isnil=0 
first=123 
ptr=0x005BB660 Left=0x005BB640 Parent=0x005BB600 Right=0x005BB680 Color=1 7 
y Isnil=0 
first=12 
ptr=0x005BB640 Left=0x005BB5E0 Parent=0x005BB660 Right=0x005BB5E0 Color=0 7 
S Isnil=0 
first=11 
ptr=0x005BB680 Left=0x005BB5E0 Parent=0x005BB660 Right=0x005BB5E0 Color=0 7 
y Isnil=0 
first=100 
ptr=0x005BB620 Left=0x005BB5E0 Parent=0x005BB600 Right=0x005BB6A0 Color=1 7 
y Isnil=0 
first=456 
ptr=0x005BB6A0 Left=0x005BB5E0 Parent=0x005BB620 Right=0x005BB5E0 Color=0 7 
y Isnil=0 
first=1001 
As a tree: 
root - - - -123 
L------- 12 
L------- 11 
R------- 100 
R------- 456 
R------- 1001 
s.begin(): 
ptr=0x005BB640 Left=0x005BB5E0 Parent=0x005BB660 Right=0x005BB5E0 Color=0 7 
y Isnil=0 
first=11 
s.end(): 
ptr=0x005BB5E0 Left=0x005BB640 Parent=0x005BB600 Right=0x005BB6A0 Color=1 7 
S Isnil=1 


The structure is not packed, so both char values occupy 4 bytes each. 


As for std: :map, first and second can be viewed asa single value of type std: : pair. 
std: :set has only one value at this address in the structure instead. 


The current size of the tree is always present, as in the case of the implementation 
of std: :list in MSVC (3.21.4 on page 723). 


As in the case of std: : list, the iterators are just pointers to nodes. The .begin() 
iterator points to the minimal key. 


That pointer is not stored anywhere (as in lists), the minimal key of the tree is looked 
up every time. operator-- and operator++ move the current node pointer to the 
predecessor or successor respectively, i.e., the nodes which have the previous or 
next key. 
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The algorithms for all these operations are explained in [Cormen, Thomas H. and 
Leiserson, Charles E. and Rivest, Ronald L. and Stein, Clifford, Introduction to Algo- 
rithms, Third Edition, (2009)]. 


The .end() iterator points to the dummy node, it has 1 in Isnil, which implies that 
the node has no key and/or value. It can be viewed as a “landing zone” in HDD?? 
and often called sentinel [see N. Wirth, Algorithms and Data Structures, 1985] ?^. 


The "parent" field of the dummy node points to the root node, which serves as a 
vertex of the tree and contains information. 


GCC 


#include <stdio.h> 
#include <map> 
#include <set> 
#include <string> 
#include <iostream> 


struct map pair 


int key; 
const char *value; 
$; 
struct tree node 
1 
int M_color; // 0 - Red, 1 - Black 
struct tree node *M parent; 
struct tree node *M left; 
struct tree node *M right; 
}; 
struct tree_struct 
{ 
int M_key_compare; 
struct tree_node M header; 
size t M node_count; 
}; 


void dump tree node (struct tree node *n, bool is set, bool traverse, bool 7 
y dump keys and values) 
1 


printf ("ptr=0x%p M_left=0x%p M_parent=0x%p M_right=0x%p M color=%d\n", 
n, n->M_left, n->M_parent, n->M_right, n->M_color); 


void *point_after_struct=((char*)n)+sizeof(struct tree node); 


if (dump keys and values) 


1 


33 Hard Disk Drive 
34http://ww.ethoberon.ethz.ch/WirthPubl/AD. pdf 
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yi 


if (is_set) 
printf ("key=%d\n", *(int*)point after struct); 

else 

{ 
struct map pair *p=(struct map pair *)point after struct; 
printf ("key=%d value=[%S]\n", p->key, p-»value); 


}; 


if (traverse==false) 
return; 


if (n->M_left) 

dump tree node (n->M_left, is set, traverse, dump keys and values); 
if (n-»M right) 

dump tree node (n->M_right, is set, traverse, dump keys and values)7 


const char* ALOT OF TABSZ"NENtENENENENENENENENEN E" ; 


void dump as tree (int tabs, struct tree node *n, bool is set) 


{ 


i 


void *point_after_struct=((char*)n)+sizeof(struct tree node); 


if (is set) 
printf ("%sd\n", *(int*)point after struct); 

else 

1 
struct map pair *p=(struct map pair *)point after struct; 
printf ("%d [%s]\n", p->key, p->value); 


} 

if (n->M_left) 

{ 
printf ("%.*sL------- ", tabs, ALOT OF TABS) ; 
dump as tree (tabs+1, n-»M left, is set); 

}; 

if (n->M_right) 

{ 
printf ("%.*sR------- ", tabs, ALOT OF TABS); 
dump as tree (tabs+1, n-»M right, is set); 

$; 


void dump map and set(struct tree struct *m, bool is set) 


{ 


printf ("ptr=0x%p, M_key_compare=0x%x, M header=0x%p, M node count=%dWn 7 
"m 
m, m--»M key compare, &m->M_ header, m-»-M node count); 
dump tree node (m->M_header.M parent, is set, true, true); 
printf ("As a tree:\n"); 
printf ("root----"); 
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dump as tree (1, m->M_header.M parent, is set); 


int main() 
// map 
std::map<int, const char*» m; 


m[10]="ten"; 
m[20]="twenty"; 
m[3]="three"; 

m[101]2"one hundred one"; 
m[100]2"one hundred"; 
m[12]2"twelve"; 

m[107]="one hundred seven"; 
m[0]2"zero"; 

m[1]="one"; 

m[6]="six"; 
m[99]="ninety-nine"; 
m[5]="five"; 
m[11]="eleven"; 
m[1001]="one thousand one"; 
m[1010]="one thousand ten"; 
m[2]="two"; 

m[9]2"nine"; 


printf ("dumping m as map:\n"); 
dump map and set ((struct tree struct *)(void*)&m, false); 


std::map<int, const char*>::iterator itl=m.begin(); 

printf ("m.begin():\n"); 

dump tree node ((struct tree node *)*(void**)8it1, false, false, true); 
itl=m.end(); 

printf ("m.end():\n"); 

dump tree node ((struct tree node *)*(void**)8it1, false, false, false) 
Gj 


// set 


std::set<int> s; 
.insert(123); 
.insert(456); 
.insert(11); 
.insert(12); 
.insert(100); 

s.insert(1001); 

printf ("dumping s as set:\n"); 

dump map and set ((struct tree struct *)(void*)&s, true); 
std::set<int>::iterator it2=s.begin(); 

printf ("s.begin():\n"); 

dump tree node ((struct tree node *)*(void**)&it2, true, false, true); 
it2=s.end(); 


nnnn un 
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printf ("s.end():\n"); 


dump tree node ((struct tree node *)*(void**)&it2, true, false, false); 


ur 


Listing 3.119: GCC 4.8.1 


dumping m as map: 


ptr=0x0028FE3C, M key compare=0x402b70, M header=0x0028FE40, M node count? 


S =17 


ptr-0x007A4988 M left-0x007A4C00 M parent-0x0028FE40 M right-0x007A4B80 7 


4 M color-1 

key=10 value=[ten] 

ptr=0x007A4C00 M left-0x007A4BEO 
4 M color-1 

key=1 value=[one] 

ptr=0x007A4BE0 M left-0x00000000 
4 M color-1 

key=0 value=[zero] 

ptr=0x007A4C60 M left=0x007A4B40 
4 M color-0 

key=5 value=[five] 

ptr=0x007A4B40 M left=0x007A4CEO 
4 M color-1 

key=3 value=[three] 

ptr-0x007A4CEO M left-0x00000000 
y M color-0 

key=2 value=[two] 

ptr=0x007A4C20 M left-0x00000000 
4 M color-1 

key=6 value=[six] 

ptr-0x007A4D00 M left-0x00000000 
4 M color-0 

key=9 value=[nine] 

ptr=0x007A4B80 M left-0x007A49A8 
4 M color-1 

key=100 value=[one hundred] 

ptr=0x007A49A8 M left=0x007A4BA0 
y M color-0 

key=20 value=[twenty] 

ptr=0x007A4BA0 M left-0x007A4C80 
4 M color-1 

key=12 value=[twelve] 

ptr=0x007A4C80 M_left=0x00000000 
«y M_color=0 

key=11 value=[eleven] 

ptr-0x007A4C40 M left-0x00000000 
4 M color-1 

key=99 value=[ninety-nine] 

ptr-0x007A4BCO M left-0x007A4B60 
4 M color-0 


key=107 value=[one hundred seven] 


M_parent=0x007A4988 


M_parent=0x007A4C00 


M_parent=0x007A4C00 


M_parent=0x007A4C60 


M_parent=0x007A4B40 


M_parent=0x007A4C60 


M_parent=0x007A4C20 


M_parent=0x007A4988 


M_parent=0x007A4B80 


M_parent=0x007A49A8 


M parent-0x007A4BAO0 


M_parent=0x007A49A8 


M_parent=0x007A4B80 


M_right=0x007A4C60 


M_right=0x00000000 


M_right=0x007A4C20 


M_right=0x00000000 


M_right=0x00000000 


M_right=0x007A4D00 


M_right=0x00000000 


M_right=0x007A4BC0 


M_right=0x007A4C40 


M_right=0x00000000 


M_right=0x00000000 


M_right=0x00000000 


M_right=0x007A4CA0 


ptr=0x007A4B60 M_left=0x00000000 M parent=0x007A4BCO M_right=0x00000000 


vy M_color=1 
key=101 value=[one hundred one] 
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ptr=0x007A4CA0 M left-0x00000000 M parentz0x007A4BCO M_right=0x007A4CC0 7 
4 M color-1 
key=1001 value-[one thousand one] 
ptr=0x007A4CC0 M left-0x00000000 M parent=0x007A4CAO M right-0x00000000 7 


4 M color-0 
key=1010 value-[one thousand ten] 
As a tree: 
root----10 [ten] 
L------- 1 [one] 
L------- 0 [zero] 
R------- 5 [five] 
L------- 3 [three] 
L------- 2 [two] 
R------- 6 [six] 
R------- 9 [nine] 
R------- 100 [one hundred] 
L------- 20 [twenty] 
L------- 12 [twelve] 
L------- 11 [eleven] 
R------- 99 [ninety-nine] 
R------- 107 [one hundred seven] 
L------- 101 [one hundred one] 
R------- 1001 [one thousand one] 
R------- 1010 [one thousand ten] 
m.begin(): 
ptr-0x007A4BEO M left-0x00000000 M parent=0x007A4C00 M right-0x00000000 7 
4 M color-1 
key=0 value=[zero] 
m.end(): 
ptr=0x0028FE40 M left-0x007A4BEO M parent=0x007A4988 M right-0x007A4CCO 7 
«y M color-0 


dumping s as set: 

ptr=0x0028FE20, M key compare-0x8, M header=0x0028FE24, M node count-6 

ptr-0x007A1E80 M left-0x01D5D890 M parent-0x0028FE24 M right-0x01D5D850 7 
4 M color-1 

key-123 

ptr=0x01D5D890 M left-0x01D5D870 M parent-0x007A1E80 M right-0x01D5D8BO 7 
4 M color-1 

key-12 

ptr=0x01D5D870 M left-0x00000000 M parent-0x01D5D890 M right-0x00000000 7 
4 M color-0 

key-11 

ptr=0x01D5D8B0 M left-0x00000000 M parent=0x01D5D890 M right-0x00000000 7 
4 M color-0 

key=100 

ptr=0x01D5D850 M left-0x00000000 M parent=0x007A1E80 M right-0x01D5D8DO 7 
4 M color-1 

key=456 

ptr=0x01D5D8D0 M left-0x00000000 M parent=0x01D5D850 M right-0x00000000 v 
y M color-0 

key-1001 

As a tree: 
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root----123 
L------- 12 
L------- 11 
R------- 100 
R------- 456 
R------- 1001 
s.begin(): 
ptr=0x01D5D870 M left-0x00000000 M parent=0x01D5D890 M right-0x00000000 7 
y M color-0 
key-11 
s.end(): 
ptr=0x0028FE24 M left-0x01D5D870 M parent-0x007A1E80 M right-0x01D5D8DO 7 
4 M_color=0 


GCC's implementation is very similar ??. The only difference is the absence of the 
Isnil field, so the structure occupies slightly less space in memory than its imple- 
mentation in MSVC. 


The dummy node is also used as a place to point the .end() iterator also has no key 
and/or value. 


Rebalancing demo (GCC) 


Here is also a demo showing us how a tree is rebalanced after some insertions. 


Listing 3.120: GCC 


#include <stdio.h> 
#include <map> 
#include <set> 
#include <string> 
#include <iostream> 


struct map pair 


1 
int key; 
const char *value; 
$; 
struct tree node 
1 
int M color; // 0 - Red, 1 - Black 
struct tree node *M parent; 
struct tree node *M left; 
struct tree node *M right; 
$; 


struct tree struct 


int M key compare; 


35http://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-html-USERS-4.1/stl__tree_ 
8h- source. html 
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struct tree node M header; 
size t M node count; 
Hh 
const char* ALOT OF TABSZ"NtNENENENENENENENENEN E" ; 


void dump as tree (int tabs, struct tree node *n) 


1 
void *point_after_struct=((char*)n)+sizeof(struct tree node); 
printf ("%d\n", *(int*)point after struct); 
if (n-»M left) 
1 
printf ("%.*sL------- ", tabs, ALOT OF TABS); 
dump_as tree (tabs+1, n->M_left); 
$; 
if (n->M_right) 
1 
printf ("%.*SR------- ", tabs, ALOT OF_TABS); 
dump as tree (tabs+1, n->M_right); 
$; 
$; 
void dump map and set(struct tree struct *m) 
1 
printf ("root----"); 
dump as tree (1, m->M_header.M parent); 
}; 
int main() 
{ 


std::set<int> s; 

s.insert(123); 

s.insert(456); 

printf ("123, 456 has been inserted\n"); 
dump map and set ((struct tree struct *)(void*)&s); 
s.insert(11); 

s.insert(12); 

printf ("Xn"); 

printf ("11, 12 has been inserted\n"); 
dump map and set ((struct tree struct *)(void*)6&s); 
s.insert(100); 

s.insert(1001); 

printf ("Xn"); 

printf ("100, 1001 has been inserted\n") ; 
dump map and set ((struct tree struct *)(void*)&s) ; 
s.insert(667); 
s.insert(1); 
s.insert(4); 
s.insert(7); 

printf ("Xn"); 

printf ("667, 1, 4, 7 has been inserted\n") ; 
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dump map and set ((struct tree struct *)(void*)6&s); 
printf ("Xn"); 
$; 


Listing 3.121: GCC 4.8.1 


123, 456 has been inserted 


root ----123 
R------- 456 
11, 12 has been inserted 
root----123 
ETE 11 
BHerisses 12 
R------- 456 
100, 1001 has been inserted 
root----123 
sisas 12 
ascos 11 
R------- 100 
R------- 456 
R------- 1001 
667, 1, 4, 7 has been inserted 
root----12 
listik 4 
EE 1 
Resesi 11 
[osasse 7 
R------- 123 
L------- 100 
R------- 667 
L------- 456 
R------- 1001 


3.21.5 Memory 


Sometimes you may hear from C++ programmers “allocate memory on stack” and/or 
“allocate memory on heap”. 


Allocating object on stack: 


void f() 
{ 


Class o=Class(...); 


Hi 
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The memory for object (or structure) is allocated in stack, using simple SP shift. The 
memory is deallocated upon function exit, or, more precisely, at the end of scope— 
SP is returning to its state (same as at the start of function) and destructor of Class 
is called. In the same manner, memory for allocated structure in C is deallocated 
upon function exit. 


Allocating object on heap: 


void f1() 
{ 


Class *o=new Class(...); 


y 
void f2() 
{ 
delete o; 
y: 


This is the same as allocating memory for a structure using malloc() call. In fact, new 
in C++ is wrapper for malloc(), and delete is wrapper for free(). Since memory block 
has been allocated in heap, it must be deallocated explicitly, using delete. Class 
destructor will be automatically called right before that moment. 


Which method is better? Allocating on stack is very fast, and good for small, short- 
lived object, which will be used only in the current function. 


Allocating on heap is slower, and better for long-lived object, which will be used 
across many functions. Also, objects allocated in heap are prone to memory leakage, 
because they must to be freed explicitly, but one can forget about it. 


Anyway, this is matter of taste. 


3.22 Negative array indices 


It’s possible to address the space before an array by supplying a negative index, e.g., 
array|-1]. 


3.22.1 Addressing string from the end 


Python PL allows to address arrays and strings from the end. For example, string[-1] 
returns the last character, string[-2] returns penultimate, etc. Hard to believe, but 
this is also possible in C/C++: 
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#include <string.h> 
#include <stdio.h> 


int main() 
{ 
char *s="Hello, world!"; 
char *s_end=s+strlen(s); 


printf ("last character: %c\n", s_end[-1]); 
printf ("penultimate character: %c\n", s end[-2]); 
$; 


It works, but s end must always has an address of terminating zero byte at the end 
of s string. If s string's size get changed, s end must be updated. 


The trick is dubious, but again, this is a demonstration of negative indices. 


3.22.2 Addressing some kind of block from the end 


Let's first recall why stack grows backwards (1.9.1 on page 41). There is some kind 
of block in memory and you want to store both heap and stack there, and you are 
not sure, how big they both can grow during runtime. 


You can set a heap pointer to the beginning of the block, then you can set a stack 
pointer to the end of the block (heap + size of block), and then you can address nth 
element of stack like stack[-n]. For example, stack[-1] for 1st element, stack[-2] for 
2nd, etc. 


This will work in the same fashion, as our trick of addressing string from the end. 


You can easily check if the structures has not begun to overlap each other: just be 
sure that address of the last element in heap is below the address ofthe last element 
of stack. 


Unfortunately, -0 as index will not work, since two's complement way of represent- 
ing negative numbers don't allow negative zero, so it cannot be distinguished from 
positive zero. 


This method is also mentioned in "Transaction processing", Jim Gray, 1993, "The 
Tuple-Oriented File System" chapter, p. 755. 


3.22.3 Arrays started at 1 


Fortran and Mathematica defined first element of array as 1th, probably because 
this is tradition in mathematics. Other PLs like C/C++ defined it as Oth. Which is 
better? Edsger W. Dijkstra argued that latter is better *°. 


But programmers may still have a habit after Fortran, so using this little trick, it's 
possible to address the first element in C/C++ using index 1: 


36See https://www.cs.utexas.edu/users/EWD/transcriptions/EWDO8xx/EWD831.html 
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#include <stdio.h> 


int main() 
{ 
int random value=0x11223344; 
unsigned char array[10]; 
int i; 
unsigned char *fakearray=&array[-1]; 


for (i=0; i<10; i++) 
array[i]-i; 


printf ("first element %d\n", fakearray[1]); 
printf ("second element %d\n", fakearray[2]); 
printf ("last element %d\n", fakearray[10]) ; 


printf ("array[-1]=%02X, array[-2]=%02X, array[-3]=%02X, array 
S [-4]=%02X\n", 


array[-1], 
array[-2], 
array[-3], 
array[-4]); 
$; 
Listing 3.122: Non-optimizing MSVC 2010 
$SG2751 DB 'first element %d', OaH, 00H 
$SG2752 DB ‘second element %d', OaH, 00H 
$SG2753 DB ‘last element %d', OaH, 00H 
$5G2754 DB 'array[-1]=%02X, array[-2]=%02X, array[-3]=%02X, array[-4' 
DB ']=%02X', OaH, 00H 
_fakearray$ = -24 ; size = 4 
random value$ = -20 ; size = 4 
_array$ = -16 ; size = 10 
i$ = -4 ; size = 4 
main PROC 
push ebp 
mov ebp, esp 
sub esp, 24 
mov DWORD PTR random value$[ebp], 287454020 ; 11223344H 
; set fakearray[] one byte earlier before array[] 
lea eax, DWORD PTR array$[ebp] 
add eax, -1 ; eax=eax-1 
mov DWORD PTR _fakearray$[ebp], eax 
mov DWORD PTR i$[ebp], 0 
jmp SHORT $LN3@main 
; fill array[] with 0..9 
$LN2@main: 
mov ecx, DWORD PTR  i$[ebp] 
add ecx, 1 
mov DWORD PTR i$[ebp], ecx 
$LN3@main: 
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cmp DWORD PTR i$[ebp], 10 
jge SHORT $LN1@main 
mov edx, DWORD PTR _i$[ebp] 
mov al, BYTE PTR i$[ebp] 
mov BYTE PTR array$[ebp«edx], al 
jmp SHORT $LN2@main 
$LN1@main: 

mov ecx, DWORD PTR fakearray$[ebp] 
; ecx=address of fakearray[0], ecx+1 is fakearray[1] or array[0] 
movzx edx, BYTE PTR [ecx+1] 
push edx 
push OFFSET $SG2751 ; ‘first element %d' 
call _printf 
add esp, 8 
mov eax, DWORD PTR fakearray$[ebp] 
; eax-address of fakearray[0], eax+2 is fakearray[2] or array[1] 
movzx ecx, BYTE PTR [eax+2] 
push ecx 
push OFFSET $SG2752 ; ‘second element %d' 
call | printf 
add esp, 8 
mov edx, DWORD PTR _fakearray$[ebp] 
; edx=address of fakearray[0], edx+10 is fakearray[10] or array[9] 
movzx eax, BYTE PTR [edx+10] 
push eax 
push OFFSET $SG2753 ; ‘last element %d' 
call _ printf 
add esp, 8 
; subtract 4, 3, 2 and 1 from pointer to array[0] in order to find 

values before array[] 
lea ecx, DWORD PTR array$[ebp] 
movzx edx, BYTE PTR [ecx-4] 
push edx 
lea eax, DWORD PTR array$[ebp] 
movzx ecx, BYTE PTR [eax-3] 
push ecx 
lea edx, DWORD PTR array$[ebp] 
movzx eax, BYTE PTR [edx-2] 
push eax 
lea ecx, DWORD PTR array$[ebp] 
movzx edx, BYTE PTR [ecx-1] 
push edx 
push OFFSET $SG2754 ; 

'array[-1]=%02X, array[-2]=%02X, array[-3]=%02X, array[-4]=%02X' 
call _ printf 
add esp, 20 
xor eax, eax 
mov esp, ebp 
pop ebp 
ret 0 

main  ENDP 


So we have array[] of ten elements, filled with 0...9 bytes. 
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Then we have the fakearray[] pointer, which points one byte before array[]. 


fakearray[1] points exactly to array[0]. But we are still curious, what is there be- 
fore array[]? We have added random value before array[] and set it to 0x11223344. 
The non-optimizing compiler allocated the variables in the order they were declared, 
so yes, the 32-bit random value is right before the array. 


We ran it, and: 


first element 0 

second element 1 

last element 9 

array[-1]=11, array[-2]=22, array[-3]=33, array[-4]=44 


Here is the stack fragment we will copypaste from OllyDbg’s stack window (with 
comments added by the author): 


Listing 3.123: Non-optimizing MSVC 2010 


CPU Stack 

Address Value 
001DFBCC /001DFBD3 ; fakearray pointer 

001DFBDO |11223344 ; random value 

001DFBD4 |03020100 ; 4 bytes of array[] 

001DFBD8 |07060504 ; 4 bytes of array[] 

001DFBDC |00CB0908 ; random garbage + 2 last bytes of array[] 
001DFBEO |0000000A ; last i value after loop was finished 
001DFBE4 |001DFC2C ; saved EBP value 

001DFBE8 X00CB129D ; Return Address 


The pointer to the fakearray[] (0x001DFBD3) is indeed the address of array[] in 
the stack (0x001DFBD4), but minus 1 byte. 


It's still very hackish and dubious trick. Doubtfully anyone should use itin production 
code, but as a demonstration, it fits perfectly here. 


3.23 More about pointers 


The way C handles pointers, for example, 
was a brilliant innovation; it solved a lot of 
problems that we had before in data 
structuring and made the programs look 
good afterwards. 


Donald Knuth, interview (1993) 


For those, who still have hard time understanding C/C++ pointers, here are more 
examples. Some of them are weird and serves only demonstration purpose: use 
them in production code only if you really know what you're doing. 
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3.23.1 Working with addresses instead of pointers 


Pointer is just an address in memory. But why we write char* string instead of 
something like address string? Pointer variable is supplied with a type of the value 
to which pointer points. So then compiler will be able to catch data typization bugs 
during compilation. 


To be pedantic, data typing in programming languages is all about preventing bugs 
and self-documentation. It's possible to use maybe two of data types like int (or 
int64 t) and byte—these are the only types which are available to assembly lan- 
guage programmers. But it's just very hard task to write big and practical assembly 
programs without nasty bugs. Any small typo can lead to hard-to-find bug. 


Data type information is absent in a compiled code (and this is one of the main 
problems for decompilers), and | can demonstrate this. 


This is what sane C/C++ programmer can write: 


#include <stdio.h> 
#include <stdint.h> 


void print_string (char *s) 


{ 
printf ("(address: Ox%llx)\n", s); 
printf ("%s\n", s); 
F; 
int main() 
1 
char *sz"Hello, world!"; 
print string (s); 
$; 


This is what | can write: 


#include <stdio.h> 
#include <stdint.h> 


void print_string (uint64 t address) 


{ 
printf ("(address: @x%llx)\n", address); 
puts ((char*)address) ; 
}; 
int main() 
{ 
char *s="Hello, world!"; 
print string ((uint64 t)s); 
}; 


| use uint64 t because | run this example on Linux x64. int would work for 32-bit 
OS-es. First, a pointer to character (the very first in the greeting string) is casted 
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to uint64 t, then it's passed further. print string() function casts back incoming 
uint64 t value into pointer to a character. 


What is interesting is that GCC 4.8.4 produces identical assembly output for both 
versions: 


gcc l.c -S -masm=intel -03 -fno-inline 


.LC0: 
.string "(address: Oxsllx)VXn" 
print string: 


push rbx 
mov rdx, rdi 
mov rbx, rdi 
mov esi, OFFSET FLAT: .LCO 
mov edi, 1 
xor eax, eax 
call . printf chk 
mov rdi, rbx 
pop rbx 
jmp puts 
.LC1: 
.string "Hello, world!" 
main: 
sub rsp, 8 
mov edi, OFFSET FLAT: .LC1 
call print string 
add rsp, 8 
ret 


(l've removed all insignificant GCC directives.) 
| also tried UNIX diff utility and it shows no differences at all. 


Let's continue to abuse C/C++ programming traditions heavily. Someone may write 
this: 


#include <stdio.h> 
#include <stdint.h> 


uint8 t load byte at address (uint8 t* address) 


1 
return *address; 
//this is also possible: return address[0]; 
$; 
void print string (char *s) 
1 
char* current addressz-s; 
while (1) 
1 


char current char-load byte at address(current address); 
if (current char--0) 
break; 
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printf ("%c", current char); 
current address--; 


y; 
y; 
int main() 
i char *s="Hello, world!"; 
a print string (s); 


It can be rewritten like this: 


#include <stdio.h> 
#include <stdint.h> 


uint8 t load byte at address (uint64 t address) 


1 
return *(uint8 t*)address; 
$; 
void print string (uint64 t address) 
1 
uint64 t current address-address; 
while (1) 
1 
char current char-load byte at address(current address); 
if (current char--0) 
break; 
printf ("%c", current char); 
current address; 
$; 
$; 
int main() 
1 
char *s="Hello, world!"; 
print string ((uint64 t)s); 
}; 


Both source codes resulting in the same assembly output: 


gcc 1.c -S -masm=intel -03 -fno-inline 


load byte at address: 
movzx eax, BYTE PTR [rdi] 


ret 
print string: 
.LFB15: 
push rbx 
mov rbx, rdi 
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jmp .L4 
.L7: 
movsx edi, al 
add rbx, 1 
call putchar 
.L4: 
mov rdi, rbx 
call load byte at address 
test al, al 
jne .L7 
pop rbx 
ret 
.LC0: 
.string "Hello, world!" 
main: 
sub rsp, 8 
mov edi, OFFSET FLAT: .LCO 
call print string 
add rsp, 8 
ret 


(I have also removed all insignificant GCC directives.) 


No difference: C/C++ pointers are essentially addresses, but supplied with type 
information, in order to prevent possible mistakes at the time of compilation. Types 
are not checked during runtime—it would be huge (and unneeded) overhead. 


3.23.2 Passing values as pointers; tagged unions 


Here is an example on how to pass values in pointers: 


#include <stdio.h> 
#include <stdint.h> 


uint64 t multiplyl (uint64 t a, uint64 t b) 


1 
return a*b; 
$; 
uint64 t* multiply2 (uint64 t *a, uint64 t *b) 
1 
return (uint64 t*)((uint64 t)a*(uint64 t)b); 
$; 
int main() 
1 
printf ("%d\n", multiply1(123, 456)); 
printf ("%d\n", (uint64 t)multiply2((uint64 t*)123, (uint64 t*)456)7 
V); 
$; 


It works smoothly and GCC 4.8.4 compiles both multiply1() and multiply2() functions 
identically! 
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multiplyl: 
mov rax, rdi 
imul rax, rsi 
ret 

multiply2: 
mov rax, rdi 
imul rax, rsi 
ret 


As long as you do not dereference pointer (in other words, you don't read any data 
from the address stored in pointer), everything will work fine. Pointer is a variable 
which can store anything, like usual variable. 


Signed multiplication instruction (IMUL) is used here instead of unsigned one (MUL), 
read more about it here: 11.1 on page 1255. 


By the way, it's well-known hack to abuse pointers a little called tagged pointers. 
In short, if all your pointers points to blocks of memory with size of, let's say, 16 
bytes (or it is always aligned on 16-byte boundary), 4 lowest bits of pointer is always 
zero bits and this space can be used somehow. It's very popular in LISP compilers 
and interpreters. They store cell/object type in these unused bits, this can save 
some memory. Even more, you can judge about cell/object type using just pointer, 
with no additional memory access. Read more about it: [Dennis Yurichev, C/C++ 
programming language notes1.3]. 


3.23.3 Pointers abuse in Windows kernel 


The resource section of PE executable file in Windows OS is a section containing 
pictures, icons, strings, etc. Early Windows versions allowed to address resources 
only by IDs, but then Microsoft added a way to address them using strings. 


So then it would be possible to pass ID or string to FindResource() function. Which 
is declared like this: 


HRSRC WINAPI FindResource( 
In opt HMODULE hModule, 
In. LPCTSTR lpName, 
In. LPCTSTR lpType 

); 


IpName and IpType has char* or wchar* types, and when someone still wants to pass 
ID, he/she have to use MAKEINTRESOURCE macro, like this: 


result = FindResource(..., MAKEINTRESOURCE(1234), ...); 


It's interesting fact that MAKEINTRESOURCE is merely casting integer to pointer. In 
MSVC 2013, in the file 
Microsoft SDKs\Windows\v7.1A\Include\Ks.h we can find this: 
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#if (!defined( MAKEINTRESOURCE )) 
#define MAKEINTRESOURCE( res ) ((ULONG PTR) (USHORT) res) 
#endif 


Sounds insane. Let’s peek into ancient leaked Windows NT4 source code. In pri- 
vate/windows/base/client/module.c we can find FindResource() source code: 


HRSRC 

FindResourceA( 
HMODULE hModule, 
LPCSTR lpName, 
LPCSTR lpType 
) 


NTSTATUS Status; 
ULONG IdPath[ 3 ]; 


PVOID p; 
IdPath[ 0 ] = 0; 
IdPath[ 1] = 0; 
try { 
if ((IdPath[ 0 ] = BaseDllMapResourceIdA( lpType )) == -1) ( 
Status = STATUS INVALID PARAMETER; 
} 
else 
if ((IdPath[ 1 ] = BaseDllMapResourceIdA( lpName )) == -1) ( 


Status - STATUS INVALID PARAMETER; 


Let's proceed to BaseDlIMapResourceldA() in the same source file: 


ULONG 
BaseDllMapResourceIdA( 
LPCSTR lpId 
) 


NTSTATUS Status; 

ULONG Id; 

UNICODE STRING UnicodeString; 
ANSI STRING AnsiString; 

PWSTR s; 


try { 
if ((ULONG)lpId € LDR RESOURCE ID NAME MASK) { 
if (*lpId == '£') { 
Status = RtlCharToInteger( lpId«1, 10, &Id ); 
if (!NT SUCCESS( Status ) || Id € LDR RESOURCE ID NAME MASKy 
S) t 
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if (NT SUCCESS( Status )) { 
Status - STATUS INVALID PARAMETER; 


BaseSetLastNTError( Status ); 
Id = (ULONG)-1; 
} 


} 
else { 

RtlInitAnsiString( &AnsiString, lpId ); 

Status - RtlAnsiStringToUnicodeString( &UnicodeString, 
SAnsiString, 
TRUE 
); 
if (!NT SUCCESS( Status )){ 

BaseSetLastNTError( Status ); 

Id = (ULONG)-1; 


else { 
S = UnicodeString.Buffer; 
while (*s != UNICODE NULL) { 
*s = RtlUpcaseUnicodeChar( *s ); 
S++; 


} 


Id = (ULONG)UnicodeString.Buffer; 
} 


} 
else { 
Id = (ULONG)lpId; 
} 
} 
except (EXCEPTION EXECUTE HANDLER) { 
BaseSetLastNTError( GetExceptionCode() ); 
Id = (ULONG)-1; 


return Id; 


Ipid is ANDed with LDR RESOURCE ID NAME MASK. 
Which we can find in public/sdk/inc/ntlar.h: 


#define LDR RESOURCE ID NAME MASK OxFFFF0000 


So Ipld is ANDed with OxFFFFOOOO and if some bits beyond lowest 16 bits are still 
present, first half of function is executed (Ipld is treated as an address of string). 
Otherwise—second half (/p/d is treated as 16-bit value). 


Still, this code can be found in Windows 7 kernel32.dll file: 
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.text:0000000078D24510 ; 


. int64  fastcall BaseDllMapResourceIdA(PCSZ SourceString) 
ies 0000000078D24510 BaseDllMapResourceIdA proc near ; CODE XREF: 
indResourceExA+34 
dixo 0000000078D24510 ; 
FindResourceExA+4B 
.text:0000000078D24510 
.text:0000000078D24510 var 38 = qword ptr -38h 
.text:0000000078D24510 var 30 = qword ptr -30h 
.text:0000000078D24510 var 28 = UNICODE STRING ptr -28h 
.text:0000000078D24510 DestinationString- STRING ptr -18h 
.text:0000000078D24510 arg 8 = dword ptr 10h 
.text:0000000078D24510 
MIL QE ; FUNCTION CHUNK AT .text:0000000078D42FB4 SIZE 
En 
1:0000000078D24510 
"text :0000000078024510 push rbx 
.text:0000000078D24512 sub rsp, 50h 
text:0000000078D24516 cmp rcx, 10000h 
text:0000000078D2451D jnb loc 78D42FBA 
text:0000000078D24523 mov [rsp+58h+var_38], rcx 
text:0000000078D24528 jmp short $42 
text:0000000078D2452A ; 
text:0000000078D2452A 
.text:0000000078D2452A loc 78D2452A: ; CODE XREF: 
BaseDllMapResourceIdA-18 
.text:0000000078D2452A : 
BaseDliMapResourceIdA-1EADO 
.text:0000000078D2452A jmp short $42 
.text:0000000078D2452C ; 
.text:0000000078D2452C 
.text:0000000078D2452C loc 78D2452C: ; 
CODE XREF: BaseDllMapResourceIdA:loc 78D2452A 
.text:0000000078D2452C ; 
BaseDl LMapResourceIdA+1EB74 
. text: 0000000078D2452C mov rax, rcx 
text:0000000078D2452F add rsp, 50h 
text:0000000078D24533 pop rbx 
text:0000000078D24534 retn 
text:0000000078D24534 ; 
text:0000000078D24535 align 20h 
text:0000000078D24535 BaseDllMapResourceIdA endp 
.text:0000000078D42FB4 loc 78D42FB4: ; CODE XREF: 
BaseDllMapResourceIdA«D 
.text:0000000078D42FB4 cmp byte ptr [rcx], '#' 
.text:0000000078D42FB7 jnz short loc 78D43005 
.text:0000000078D42FB9 inc rcx 
. text: 0000000078D42FBC lea r8, [rsp+58h+arg_ 8] 
. text: 0000000078D42FC1 mov edx, OAh 
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. text: 0000000078D42FC6 call cs: imp RtlCharToInteger 
.text:0000000078D42FCC mov ecx, [rsp+58h+arg_ 8] 

. text: 0000000078D42FD0 mov [rsp+58h+var_38], rcx 

. text: 0000000078D42FD5 test eax, eax 

. text: 0000000078D42FD7 js short loc 78D42FE6 
.text:0000000078D42FD9 test rcx, OFFFFFFFFFFFF0000h 
.text:0000000078D42FE0 jz loc 78D2452A 


If value in input pointer is greater than 0x10000, jump to string processing is oc- 
curred. Otherwise, input value of /pld is returned as is. OXFFFF0000 mask is not used 
here any more, because this is 64-bit code after all, but still, OxFFFFFFFFFFFFOOOO 
could work here. 


Attentive reader may ask, what if address of input string is lower than 0x10000? 
This code relied on the fact that in Windows there are nothing on addresses below 
0x10000, at least in Win32 realm. 


Raymond Chen writes about this: 


How does MAKEINTRESOURCE work? It just stashes the integer in 
the bottom 16 bits of a pointer, leaving the upper bits zero. This relies 
on the convention that the first 64KB of address space is never mapped 
to valid memory, a convention that is enforced starting in Windows 7. 


In short words, this is dirty hack and probably one should use it only if there is 
a real necessity. Perhaps, FindResource() function in past had SHORT type for its 
arguments, and then Microsoft has added a way to pass strings there, but older 
code must also be supported. 


Now here is my short distilled example: 


#include <stdio.h> 
#include <stdint.h> 


void f(char* a) 


{ 
if (((uint64 t)a)>0x10000) 
printf ("Pointer to string has been passed: %s\n", a); 
else 
printf ("16-bit value has been passed: %d\n", (uint64 t)a); 
}; 
int main() 
{ 
f("Hello!"); // pass string 
f((char*)1234); // pass 16-bit value 
}; 
It works 
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Pointers abuse in Linux kernel 


As it has been noted in comments on Hacker News, Linux kernel also has something 
like that. 


For example, this function can return both error code and pointer: 


struct kernfs node *kernfs create link(struct kernfs node *parent, 
const char *name, 
struct kernfs node *target) 
1 
struct kernfs_node *kn; 
int error; 
kn = kernfs new node(parent, name, S IFLNK|S IRWXUGO, KERNFS LINK); 
if (!kn) 
return ERR PTR(-ENOMEM) ; 
if (kernfs ns enabled(parent)) 
kn->ns = target-»ns; 
kn->symlink.target_kn = target; 
kernfs get(target); /* ref owned by symlink */ 
error = kernfs add one(kn); 
if (lerror) 
return kn; 
kernfs put(kn); 
return ERR PTR(error); 
} 


(https://github.com/torvalds/linux/blob/fceef393a538134f03b778c5d2519e670269342f/ 
fs/kernfs/symlink.czL25 ) 


ERR PTR is a macro to cast integer to pointer: 


static inline void * _ must check ERR PTR(long error) 


{ 
} 


return (void *) error; 


(https://github.com/torvalds/linux/blob/61d0b5a4b2777dcf5daef245e212b3c1fa8091ca/ 
tools/virtio/linux/err.h) 


This header file also has a macro helper to distinguish error code from pointer: 


#define IS ERR VALUE(x) unlikely((x) >= (unsigned long) -MAX_ERRNO) 


This means, error codes are the “pointers” which are very close to -1 and, hope- 
fully, there are nothing in kernel memory on the addresses like OXFFFFFFFFFFFFFFFF, 
OxFFFFFFFFFFFFFFFE, OxFFFFFFFFFFFFFFFD, etc. 


Much more popular solution is to return NULL in case of error and to pass error code 
via additional argument. Linux kernel authors don't do that, but everyone who use 
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these functions must always keep in mind that returning pointer must always be 
checked with /S ERR VALUE before dereferencing. 


For example: 


fman-»cam offset = fman muram alloc(fman-»muram, fman-»cam size); 
if (IS ERR VALUE(fman-»cam offset)) ( 
dev err(fman-»dev, "%s: MURAM alloc for DMA CAM failed\n", 
. func ); 
return -ENOMEM; 
} 


(https://github.com/torvalds/linux/blob/aa00edc1287a693eadc7bc67a3d73555d969b35d/ 
drivers/net/ethernet/freescale/fman/fman.c#L826 ) 


Pointers abuse in UNIX userland 


mmap() function returns -1 in case of error (or MAP_ FAILED, which equals to -1). 
Some people say, mmap() can map a memory at zeroth address in rare situations, 
so it can't use O or NULL as error code. 


3.23.4 Null pointers 
"Null pointer assignment" error of MS-DOS era 


Oldschool readers may recall a weird error message of MS-DOS era: "Null pointer 
assignment". What does it mean? 


It's not possible to write a memory at zero address in *NIX and Windows OSes, but it 
was possible to do so in MS-DOS due to absence of memory protection whatsoever. 


So I’ve pulled my ancient Turbo C++ 3.0 (later it was renamed to Borland C++) from 
early 1990s and tried to compile this: 


#include <stdio.h> 


int main() 
{ 
int *ptr=NULL; 
*ptr=1234; 
printf ("Now let's read at NULL\n"); 
printf ("sdin", *ptr); 


ur 


Hard to believe, but it works, with error upon exit, though: 


Listing 3.124: Ancient Turbo C 3.0 


C:\TC30\BIN\1 

Now let's read at NULL 
1234 

Null pointer assignment 


C:\TC30\BIN>_ 
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Let's dig deeper into the source code of CRT of Borland C++ 3.1, file cO.asm: 


; checknull() check for null pointer zapping copyright message 


; Check for null pointers before exit 


. checknull PROC DIST 
PUBLIC . checknull 
IF LDATA EQ false 
IFNDEF . TINY . 
push si 
push di 
mov es, cs:DGROUP(QG 
xor ax, ax 
mov si, ax 
mov cx, lgth CopyRight 
ComputeChecksum label near 
add al, es:[si] 
adc ah, 0 
inc si 
loop ComputeChecksum 
sub ax, CheckSum 
jz EESUMOK 
mov cx, lgth NullCheck 
mov dx, offset DGROUP: NullCheck 
call ErrorDisplay 
EESUMOK : pop di 
pop si 
ENDIF 
ENDIF 
DATA SEGMENT 


; Magic symbol used by the debug info to locate the data segment 
public DATASEG@ 
DATASEG@ label byte 


; The CopyRight string must NOT be moved or changed without 
; changing the null pointer check logic 


CopyRight db 4 dup(0) 
db ‘Borland C++ - Copyright 1991 Borland Intl.',0 
lgth CopyRight equ $ - CopyRight 
IF LDATA EQ false 
IFNDEF . TINY _ 
CheckSum equ 00D5Ch 
NullCheck db 'Null pointer assignment', 13, 10 
lgth NullCheck equ $ - NullCheck 
ENDIF 
ENDIF 
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The MS-DOS memory model was really weird (11.7 on page 1264) and probably not 
worth looking into it unless you're fan of retrocomputing or retrogaming. One thing 
we have to keep in mind is that memory segment (included data segment) in MS- 
DOS is a memory segment in which code or data is stored, but unlike "serious" OSes, 
it’s started at address 0. 


And in Borland C++ CRT, the data segment is started with 4 zero bytes and the 
copyright string "Borland C++ - Copyright 1991 Borland Intl.". The integrity of the 
4 zero bytes and text string is checked upon exit, and if it's corrupted, the error 
message is displayed. 


But why? Writing at null pointer is common mistake in C/C++, and if you do so in 
*NIX or Windows, your application will crash. MS-DOS has no memory protection, 
So CRT has to check this post-factum and warn about it upon exit. If you see this 
message, this means, your program at some point has written at address 0. 


Our program did so. And this is why 1234 number has been read correctly: because 
it was written at the place of the first 4 zero bytes. Checksum is incorrect upon exit 
(because the number has been left there), so error message has been displayed. 


Am I right? I’ve rewritten the program to check my assumptions: 


#include <stdio.h> 


int main() 
{ 
int *ptr=NULL; 
*ptr=1234; 
printf ("Now let's read at NULL\n"); 
printf ("%d\n", *ptr); 
*ptr=0; // psst, cover our tracks! 


ur 


This program executes without error message upon exit. 


Though method to warn about null pointer assignment is relevant for MS-DOS, per- 
haps, it can still be used today in low-cost MCUs with no memory protection and/or 
MMU””, 


Why would anyone write at address 0? 


But why would sane programmer write a code which writes something at address 0? 
It can be done accidentally: for example, a pointer must be initialized to newly allo- 
cated memory block and then passed to some function which returns data through 
pointer. 


int *ptrzNULL; 


37Memory Management Unit 
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. we forgot to allocate memory and initialize ptr 


strcpy (ptr, buf); // strcpy() terminates silently because MS-DOS has no 
memory protection 


Even worse: 


int *ptr=malloc(1000) ; 


. we forgot to check if memory has been really allocated: this is MS-DOS ^ 
\ after all and computers had small amount of RAM, 
.. and RAM shortage was very common. 
. if malloc() returned NULL, the ptr will also be NULL. 


strcpy (ptr, buf); // strcpy() terminates silently because MS-DOS has no 
memory protection 


Writing on Oth address on purpose 


Here is an example from dmalloc??, a portable way of generating core dump, if other 
ways are not available: 


3.4 Generating a Core File on Errors 


If the 'error-abort' debug token has been enabled, when the library 
detects any problems with the heap memory, it will immediately attempt 
to dump a core file. *Note Debug Tokens::. Core files are a complete 
copy of the program and it's state and can be used by a debugger to see 
specifically what is going on when the error occurred. *Note Using 
With a Debugger::. By default, the low, medium, and high arguments to 
the library utility enable the ‘error-abort' token. You can disable 
this feature by entering ‘dmalloc -m error-abort' (-m for minus) to 
remove the 'error-abort' token and your program will just log errors 
and continue. You can also use the 'error-dump' token which tries to 
dump core when it sees an error but still continue running. *Note 
Debug Tokens::. 


When a program dumps core, the system writes the program and all of 
its memory to a file on disk usually named 'core'. If your program is 
called *foo' then your system may dump core as 'foo.core'. If you are 
not getting a ‘core' file, make sure that your program has not changed 
to a new directory meaning that it may have written the core file in a 
different location. Also insure that your program has write privileges 
over the directory that it is in otherwise it will not be able to dump 
a core file. Core dumps are often security problems since they contain 
all program memory so systems often block their being produced. You 
will want to check your user and system's core dump size ulimit 
settings. 


The library by default uses the "abort' function to dump core which 


38http: //dmalloc.com/ 
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may or may not work depending on your operating system. If the 
following program does not dump core then this may be the problem. See 
"KILL PROCESS' definition in 'settings.dist'. 


main() 


1 
abort(); 


} 
If "abort' does work then you may want to try the following setting 
in 'settings.dist'. This code tries to generate a segmentation fault 
by dereferencing a "NULL' pointer. 


#define KILL PROCESS { int * int p = 0L; * intp- 1; } 


NULL in C/C++ 


NULL in C/C++ is just a macro which is often defined like this: 


#define NULL ((void*)0) 


( libio.h file ) 


void* is a data type reflecting the fact it’s the pointer, but to a value of unknown 
data type (void). 


NULL is usually used to show absence of an object. For example, you have a single- 
linked list, and each node has a value (or pointer to a value) and next pointer. To 
show that there are no next node, 0 is stored to next field. (Other solutions are just 
worse.) Perhaps, you may have some crazy environment where you need to allocate 
memory blocks at zero address. How would you indicate absence of the next node? 
Some kind of magic number? Maybe -1? Or maybe using additional bit? 


In Wikipedia we may find this: 


In fact, quite contrary to the zero page’s original preferential use, 
some modern operating systems such as FreeBSD, Linux and Microsoft 
Windows[2] actually make the zero page inaccessible to trap uses of 
NULL pointers. 


( https://en.wikipedia.org/wiki/Zero page) 


Null pointer to function 


It’s possible to call function by its address. For example, | compile this by MSVC 2010 
and run it in Windows 7: 


#include «windows.h» 
#include <stdio.h> 


int main() 
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1 
ur 


printf ("Ox%x\n", &MessageBoxA); 


The result is 0x7578feae and doesn't changing after several times I run it, because 
user32.dll (where MessageBoxA function resides) is always loads at the same ad- 
dress. And also because ASLR?? is not enabled (result would be different each time 
in that case). 


Let's call MessageBoxA() by address: 


#include «windows.h» 
#include <stdio.h> 


typedef int (*msgboxtype) (HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, 2 
S UINT uType); 


int main() 


1 
msgboxtype msgboxaddr=0x7578feae; 


// force to Load DLL into process memory, 

// since our code doesn't use any function from user32.dll, 
// and DLL is not imported 

LoadLibrary ("user32.dll"); 


msgboxaddr(NULL, "Hello, world!", "hello", MB OK); 


F 


Weird, but works in Windows 7 x86. 


This is commonly used in shellcodes, because it's hard to call DLL functions by name 
from there. And ASLR is a countermeasure. 


Now what is really weird, some embedded C programmers may be familiar with a 
code like that: 


int reset() 

1 
void (*foo)(void) = 0; 
foo(); 

ur 


Who will want to call a function at address 0? This is portable way to jump at zero 
address. Many low-cost cheap microcontrollers also have no memory protection or 
MMU and after reset, they start to execute code at address 0, where some kind of 
initialization code is stored. So jumping to address O is a way to reset itself. One 
could use inline assembly, but if it's not possible, this portable method can be used. 


It even compiles correctly by my GCC 4.8.4 on Linux x64: 


39 Address Space Layout Randomization 
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reset: 
sub rsp, 8 
xor eax, eax 
call rax 
add rsp, 8 
ret 


The fact that stack pointer is shifted is not a problem: initialization code in microcon- 
trollers usually completely ignores registers and RAM state and boots from scratch. 


And of course, this code will crash on *NIX or Windows because of memory protection 
and even in absence of protection, there are no code at address 0. 


GCC even has non-standard extension, allowing to jump to a specific address rather 
than call a function there: http://gcc.gnu.org/onlinedocs/gcc/Labels-as-Values. 
html. 


3.23.5 Array as function argument 


Someone may ask, what is the difference between declaring function argument type 
as array and as pointer? 


As it seems, there are no difference at all: 


void write somethingl(int a[16]) 


a[5]=0; 
F 


void write something2(int *a) 


a[5]=0; 
y; 
int f() 
1 
int a[16]; 
write somethingl(a); 
write something2(a); 
y; 


Optimizing GCC 4.8.4: 


write somethingl: 
mov DWORD PTR [rdi+20], 0 
ret 


write something2: 
mov DWORD PTR [rdi+20], 0 
ret 
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But you may still declare array instead of pointer for self-documenting purposes, if 
the size of array is always fixed. And maybe, some static analysis tool will be able 
to warn you about possible buffer overflow. Or is it possible with some tools today? 


Some people, including Linus Torvalds, criticizes this C/C++ feature: https://lkml. 
0rg/1kml/2015/9/3/428. 


C99 standard also have static keyword [ISO/IEC 9899:TC3 (C C99 standard), (2007) 
6.7.5.3]: 


If the keyword static also appears within the [ and ] of the array 
type derivation, then for each call to the function, the value of the cor- 
responding actual argument shall provide access to the first element 
of an array with at least as many elements as specified by the size 
expression. 


3.23.6 Pointer to a function 


A function name in C/C++ without brackets, like “printf” is a pointer to function of 
void (*)() type. Let's try to read function's contents and patch it: 


#include <memory.h> 
#include <stdio.h> 


void print something () 


1 
printf ("we are in %s()\n", _ FUNCTION ); 
$; 
int main() 
{ 
print something(); 
printf ("first 3 bytes: %x %x 9x... Mn", 
*(unsigned char*)print something, 
*((unsigned char*)print_something+1), 
*((unsigned char*)print_something+2) ) ; 
*(unsigned char*)print_something=0xC3; // RET's opcode 
printf ("going to call patched print something():n"); 
print something(); 
printf ("it must exit at this point Wn"); 
$; 


It tells, that the first 3 bytes of functions are 55 89 e5. Indeed, these are opcodes 
of PUSH EBP and MOV EBP, ESP instructions (these are x86 opcodes). But then our 
program crashes, because text section is readonly. 


We can recompile our example and make text section writable ^?: 


“0http://stackoverflow.com/questions/27581279/make- text - segment -writable-elf 
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gcc --static -g -Wl,--omagic -o example example.c 


That works! 


we are in print something() 

first 3 bytes: 55 89 e5... 

going to call patched print something(): 
it must exit at this point 


3.23.7 Pointer to a function: copy protection 


A software cracker can find a function that checks protection and return true or false. 
He/she then can put XOR EAX, EAX / RETN or MOV EAX, 1 / RETN there. 


Can you check integrity of the function? As it turns out, this can be done easily. 


According to objdump, the first 3 bytes of check protection() are 0x55 0x89 OxE5 
(given the fact this is non-optimizing GCC): 


#include <stdlib.h> 
#include <stdio.h> 


int check protection() 


1 
// do something 
return 0; 
// or return 1; 
}; 
int main() 
{ 
if (check_protection()==0) 
{ 
printf ("no protection installed\n"); 
exit(0); 
}; 
// ...and then, at some very important point... 
if (*(((unsigned char*)check_protection)+0) != 0x55) 
{ 
printf ("1st byte has been altered\n"); 
// do something mean, add watermark, etc 
$; 
if (*(((unsigned char*)check protection)+1) != 0x89) 
1 
printf ("2nd byte has been altered\n"); 
// do something mean, add watermark, etc 
hi 
if (*(((unsigned char*)check protection)+2) != 0xe5) 
1 


printf ("3rd byte has been altered\n"); 
// do something mean, add watermark, etc 
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y; 
$; 
0000054d «check protection»: 
54d: 55 push ‘%ebp 
54e: 89 e5 mov *sesp , sebp 
550:  e8 b7 00 00 00 call 60c < x86.get pc thunk.ax» 
555: 05 7f 1a 00 00 add $0x1a7f,*seax 
55a: b8 00 00 00 00 mov $0x0 , Seax 
55f: 5d pop *sebp 
560: c3 ret 


If someone would patch the beginning of the check protection() function, your 
program can do something mean, maybe exit suddenly. To find such a trick, a cracker 
can set a memory read breakpoint on the address ofthe function's beginning. (tracer 
has BPMx options for that.) 


3.23.8 Pointer to a function: a common bug (or typo) 
A notorious bug/typo: 


int expired() 


1 
// check license key, current date/time, etc 
}; 
int main() 
{ 
if (expired) // must be expired() here 
{ 
print ("expired\n"); 
exit(0); 
} 
else 
{ 
// do something 
}; 
}; 


Since the function’s name alone is interpreted as a pointer to function, or its address, 
the if(function name) statement is like if (true). 


Unfortunately, a C/C++ compiler wouldn't issue a warning. 


3.23.9 Pointer as object identificator 


Both assembly language and C has no OOP features, but it's possible to write a code 
in OOP style (just treat structure as an object). 


It's interesting, that sometimes, pointer to an object (or its address) is called as ID 
(in sense of data hiding/encapsulation). 
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For example, LoadLibrary(), according to MSDN^!, returns “handle to the module" 
42. Then you pass this “handle” to other functions like GetProcAddress(). But in 
fact, LoadLibrary() returns pointer to DLL file mapped into memory 9. You can read 
two bytes from the address LoadLibrary() returns, and that would be “MZ” (first two 
bytes of any .EXE/.DLL file in Windows). 


Apparently, Microsoft "hides" that fact to provide better forward compatibility. Also, 
HMODULE and HINSTANCE data types had another meaning in 16-bit Windows. 


Probably, this is reason why printf() has “%p” modifier, which is used for printing 
pointers (32-bit integers on 32-bit architectures, 64-bit on 64-bit, etc) in hexadecimal 
form. Address of a structure dumped into debug log may help in finding it in another 
place of log. 


Here is also from SQLite source code: 


struct Pager { 


sqlite3 vfs *pVfs; /* OS functions to use for IO */ 

u8 exclusiveMode; /* Boolean. True if locking mode==EXCLUSIVE 2 
y */ 

u8 journalMode; /* One of the PAGER JOURNALMODE * values */ 

u8 useJournal; /* Use a rollback journal on this file */ 

u8 noSync; /* Do not sync the journal if true */ 


static int pagerLockDb(Pager *pPager, int eLock)1 
int rc = SQLITE OK; 


assert( eLock==SHARED LOCK || eLock==RESERVED LOCK || eLock==» 
S EXCLUSIVE LOCK ); 
if( pPager->eLock<eLock || pPager->eLock==UNKNOWN LOCK )4 
rc = sqlite30sLock(pPager->fd, eLock); 
if( rc==SQLITE OK && (pPager->eLock!=UNKNOWN LOCK| |eLock--7 
S EXCLUSIVE LOCK) ){ 
pPager->eLock = (u8)eLock; 
IOTRACE(("LOCK %p %d\n", pPager, eLock) ) 
F 
} 


return rc; 


PAGER INCR(sqlite3 pager readdb count); 
PAGER_INCR(pPager->nRead) ; 

IOTRACE(("PGIN %p %d\n", pPager, pgno)); 
PAGERTRACE ( ("FETCH %d page %d hash(%08x)\n", 


Microsoft Developer Network 
42https://msdn.microsoft.com/ru- ru/library/windows/desktop/ms684175(v=vs.85).aspx 
^3https://blogs.msdn.microsoft.com/oldnewthing/20041025-00/?p-37483 
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PAGERID(pPager), pgno, pager pagehash(pPg))); 


3.23.10 Oracle RDBMS and a simple garbage collector for C/C++ 


There was a time, when the author of these lines tried to learn more about Oracle 
RDBMS, searching for vulnerabilities, etc. This is a huge piece of software, and a 
typical function can take very large nested objects as arguments. And | wanted to 
dump these objects, as trees (or graphs). 


Also, | tracked all memory allocations/deallocations by intercepting memory allocat- 
ing/deallocating functions. And when a function to be intercepted getting a pointer 
to a block in memory, | search for the block in a list of blocks allocated. I’m getting 
its size + short name of block (this is like "tagging" in Windows OS kernel^^). 


Given a block, | can scan it for 32-bit words (on 32-bit OS) or for 64-bit words (on 
64-bit OS). Each word can be a pointer to another block. And if it is so (I find this 
another block in my records), | can process it recursively. 


And then, using GraphViz, | could render such a diagrams: 


cmt:[qcsctx: kkmqccr], 
+0004: ptr to [qcctx : k 


+0008: 0x02 0x00 OxDC 
| +000C: Ox65C(\) 0xD5 O 
emt:[qectx : kkmacer], size:[68] 


+0004: ptr to [ctxdef kksLoadChild] 
cmt:[qcpctx: kkmqccr], 
30014: 0x02 0x02 0x00 0x00 
cmt:[ctxdef kksLoadChild], size:[480] +0004: OxAS 0x92 Dxb+ 
+001C: ptr to [qesctx: kkmqccr] 
+0000: 0x04 0x00 0x00 0x00 NTE +0008: ptr to [qcctx : k 
: ptr to [qcpctx: kkmacer| 
+0004: 0x18 0x00 0x00 0x00 mnn s +0018: ptr to [qcptgc: k 
+0024: ptr to [qomemctx : kkmaccr] 
+000C: 0x18 0x00 0x00 0x00 
+0028: 0x68(h) 0x7 B) OxDA 0x05 
+0040: 0x00 0x00 0x00 0x08 
+0034: ptr to [qctctx: kkmacer] cmt:[qctctx: kkmqccr], 
+0044: 0x00 0x00 0x00 0x04 
+0038: ptr to [qcsqlpath: qosAddSqlPath] [ +0000: ptr to [qcctx : k 
40110: 0x28(() OxD2 OxB2 0x14 
+011C: ptr to [qcctx : kkmqccr] 
30124: ptr to [kksol : kkscuf] cmt:[kksol : kkscuf], size:[28] cmt:[qcmemctx : kkmqccr], 
+0004: 0x11 0x00 0x00 0x00 


+0000: 0x24($) 0xD5 0xB2 1 
+0004: ptr to [Typecheck he 


+0150: ptr to [Typecheck heap descriptor] 
+0144: 0xDO 0xD0 0xB2 0x14 


30148: 0x24($) 0xD5 0xB2 0x1A 


+0008: 0x01 0x00 0x00 0x00 
+000C: 0x90 0x01 0x00 0x00 


cmt:[qcsglpath: qosAddSqlF 
cmt: [kksol : kkscuf], size:[28] [ 0000: ptr to [qesalpath: qe: 


^ Read more about comments in allocated blocks: Dennis Yurichev, C/C++ programming language 
notes http://yurichev.com/C-book.html 
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Bigger pictures: 1, 2. 


This is quite impressive, given the fact that | had no information about data types of 
all these structures. But | could get some information from it. 


Now the garbage collector for C/C++: Boehm GC 


If you use a block allocated in memory, its address has to be present somewhere, as 
a pointer in some structure/array in another allocated block, or in globally allocated 
structure, or in local variable in stack. If there are no pointer to a block, you can call 
it "orphan", and it will be a reason of memory leak. 


And this is what GC* does. It scans all blocks (because it keep tabs on all blocks 
allocated) for pointers. It's important to understand, that it has no idea of data types 
of all these structure fields in blocks—this is important, GC has no information about 
types. It just scans blocks for 32-bit of 64-bit words and see, if they could be a 
pointers to another block(s). It also scans stack. It treats allocated blocks and stack 
as arrays of words, some of which may be pointers. And if it found a block allocated, 
which is “orphaned”, i.e., there are no pointer(s) to it from another block(s) or stack, 
this block considered unneeded, to be freed. Scanning process takes time, and this 
is what for GCs are criticized. 


Also, GC like Boehm GC** (for pure C) has function like GC_malloc_atomic () —using 
it, you declare that the block allocated using this function will never contain any 
pointer(s) to other block(s). Maybe this could be a text string, or other type of data. 
(Indeed, GC strdup() calls GC malloc atomic().) GC will not scan it. 


3.24 Loop optimizations 


3.24.1 Weird loop optimization 


This is a simplest ever memcpy() function implementation: 


void memcpy (unsigned char* dst, unsigned char* src, size t cnt) 
1 
size t i; 
for (i20; i«cnt; i++) 
dst[i]ssrc[i]; 
}; 


At least MSVC 6.0 from the end of 1990s till MSVC 2013 can produce a really weird 
code (this listing is generated by MSVC 2013 x86): 


_dst$ = 8 ; size = 4 

_src$ = 12 ; size = 4 

_cnt$ = 16 ; size = 4 

 memcpy PROC 
mov edx, DWORD PTR _cnt$[esp-4] 
test edx, edx 


45 Garbage Collector 
46https://www.hboehm. info/gc/ 
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je SHORT $LN1@f 
mov eax, DWORD PTR dst$[esp-4] 
push esi 
mov esi, DWORD PTR src$[esp] 
sub esi, eax 
; ESI=src-dst, i.e., pointers difference 
$LL8Qf : 
mov cl, BYTE PTR [esi+eax] ; load byte at "esi-«dst" or at 
"src-dst+dst" at the beginning or at just "src" 
lea eax, DWORD PTR [eax+1] ; dst++ 
mov BYTE PTR [eax-1], cl ; store the byte at "(dst++)--" or at 
just "dst" at the beginning 
dec edx ; decrement counter until we finished 
jne SHORT $LL8@f 
pop esi 
$LN1@f : 
ret 0 


_memcpy ENDP 


This is weird, because how humans work with two pointers? They store two ad- 
dresses in two registers or two memory cells. MSVC compiler in this case stores 
two pointers as one pointer (sliding dst in EAX) and difference between src and dst 
pointers (left unchanged over the span of loop body execution in ESI). (By the way, 
this is a rare case when ptrdiff_t data type can be used.) When it needs to load a 
byte from src, it loads it at diff + sliding dst and stores byte at just sliding dst. 


This has to be some optimization trick. But I’ve rewritten this function to: 


_f2 PROC 
mov edx, DWORD PTR  cnt$[esp-4] 
test edx, edx 
je SHORT $LN1@f 
mov eax, DWORD PTR _dst$[esp-4] 
push esi 
mov esi, DWORD PTR src$[esp] 
; eax=dst; esi=src 
$LL8@f : 
mov cl, BYTE PTR [esi+edx] 
mov BYTE PTR [eax+edx], cl 
dec edx 
jne SHORT $LL8@f 
pop esi 
$LN1@f: 
ret 0 
f2 ENDP 


..and it works as efficient as the optimized version on my Intel Xeon E31220 O 
3.10GHz. Maybe, this optimization was targeted some older x86 CPUs of 1990s era, 
since this trick is used at least by ancient MS VC 6.0? 


Any idea? 
Hex-Rays 2.2 have a hard time recognizing patterns like that (hopefully, temporary?): 
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void cdecl fl(char *dst, char *src, size t size) 

{ 
size t counter; // edx@l 
char *sliding dst; // eax@2 
char tmp; // cl@3 


counter = size; 
if ( size ) 


{ 
Sliding dst = dst; 
do 
{ 
tmp = (sliding dst++)[src - dst]; // difference (src-dst) is 


calculated once, at the beginning 
*(sliding dst - 1) = tmp; 
--counter; 

} 


while ( counter ); 


Nevertheless, this optimization trick is often used by MSVC (not just in DIY*” home- 
brew memcpy() routines, but in many loops which uses two or more arrays), so it's 
worth for reverse engineers to keep it in mind. 


3.24.2 Another loop optimization 


If you process all elements of some array which happens to be located in global 
memory, compiler can optimize it. For example, let's calculate a sum of all elements 
of array of 128 int's: 


#include <stdio.h> 
int a[128]; 


int sum of a() 


1 
int rt=0; 


for (int i20; i<128; i++) 
rt=rt+a[i]; 


return rt; 


3 


int main() 
{ 
// initialize 
for (int i20; i<128; i++) 
alil=i; 


47Do It Yourself 
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ur 


// calculate the sum 


printf ("%d\n", sum of 


a()); 


Optimizing GCC 5.3.1 (x86) can produce this (IDA): 


.text:080484B0 sum of a proc near 
.text:080484B0 mov edx, offset a 
.text:080484B5 xor eax, eax 
.text:080484B7 mov esi, esi 
.text:080484B9 lea edi, [edi+0] 
. text: 080484C0 
.text:080484C0 loc 80484C0: ; CODE XREF: sum of a+1B 
.text:080484C0 add eax, [edx] 
.text:080484C2 add edx, 4 
.text:080484C5 cmp edx, offset 7 
$ — libc start _main@@GLIBC 2 0 
.text:080484CB jnz short loc 80484CO0 
.text:080484CD rep retn 
.text:080484CD sum of a endp 
.text:080484CD 
.bss:0804A040 public a 
.bss:0804A040 a dd 80h dup(?) ; DATA XREF: main:loc 8048338 
.bss:0804A040 ; main+19 
.bss:0804A040 _ bss ends 
.bss:0804A040 
extern:0804A240 ; 
extern:0804A240 
extern:0804A240 ; Segment type: Externs 
extern:0804A240 ; extern 
extern:0804A240 extrn  libc start _main@@GLIBC 2 0:near 
extern:0804A240 ; DATA XREF: main+25 
extern:0804A240 ; main+5D 
extern:0804A244 extrn  printf _chk@@GLIBC 2 3 4:near 
extern:0804A248 extrn  libc start main:near 
extern:0804A248 ; CODE XREF: libc start main 
extern:0804A248 ; DATA XREF: .got.plt:off 804A00C 


What the heck is libc start 
just after end of a[] array. The function can be rewritten like this: 


main@@GLIBC 2 0 at 0x080484C5? This is a label 


int su 


{ 


m of a v2() 


int *tmp=a; 
int rt=0; 


do 


{ 
rt=rt+(*tmp) ; 
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tmp++; 
} 
while (tmp<(a+128)); 


return rt; 


Fi 


First version has ¡ counter, and the address of each element of array is to be cal- 
culated at each iteration. The second version is more optimized: the pointer to 
each element of array is always ready and is sliding 4 bytes forward at each itera- 
tion. How to check if the loop is ended? Just compare the pointer with the address 
just behind array's end, which is, in our case, is happens to be address of imported 
libc start main() function from Glibc 2.0. Sometimes code like this is confus- 
ing, and this is very popular optimizing trick, so that’s why | made this example. 


My second version is very close to what GCC did, and when | compile it, the code is 
almost the same as in first version, but two first instructions are swapped: 


.text:080484D0 public sum of a v2 
.text:080484D0 sum of a v2 proc near 
.text:080484D0 xor eax, eax 
.text:080484D2 mov edx, offset a 
.text:080484D7 mov esi, esi 
.text:080484D9 lea edi, [edi+0] 
.text:080484E0 
.text:080484E0 loc 80484E0: ; CODE XREF: sum of a v2+1B 
.text:080484E0 add eax, [edx] 
.text:080484E2 add edx, 4 
.text:080484E5 cmp edx, offset 7 

$ — libc start _main@@GLIBC 2 0 
.text:080484EB jnz short loc 80484E0 
.text:080484ED rep retn 
.text:080484ED sum of a v2 endp 


Needless to say, this optimization is possible if the compiler can calculate address 
of the end of array during compilation time. This happens if the array is global and 
it's size is fixed. 

However, if the address of array is unknown during compilation, but size is fixed, 
address of the label just behind array's end can be calculated at the beginning of 
the loop. 


3.25 More about structures 


3.25.1 Sometimes a C structure can be used instead of array 


Arithmetic mean 


#include <stdio.h> 


int mean(int *a, int Len) 
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int sum=0; 

for (int i20; i<len; i++) 
sum-sum-a [i]; 

return sum/len; 


Fi 


struct five_ints 
{ 
int a0; 
int al; 
int a2; 
int a3; 
int a4; 
$; 


int main() 
1 
struct five ints a; 
a.a0=123; 
a.al=456; 
a.a2=789; 
a.a3=10; 
a.a4=100; 
printf ("%d\n", mean(&a, 5)); 
// test: 
https: //ww.wolframalpha.com/input/?i=mean(123,456,789,10,100) 


This works: mean() function will never access behind the end of five ints structure, 
because 5 is passed, meaning, only 5 integers will be accessed. 


Putting string into structure 


#include <stdio.h> 


struct five chars 
1 
char a0; 
char al; 
char a2; 
char a3; 
char a4; 
} attribute ((aligned (1),packed) ); 


int main() 
{ 
struct five chars a; 
a.a0='h'; 
a.al='i'; 
a.a2='!'; 
a.a3='\n'; 
a.a4=0; 
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printf (&a); // prints "hi!" 
Fi 


((aligned (1),packed)) attribute must be used, because otherwise, each structure 
field will be aligned on 4-byte or 8-byte boundary. 
Summary 


This is just another example of how structures and arrays are stored in memory. 
Perhaps, no sane programmer will do something like in this example, except in case 
of some specific hack. Or maybe in case of source code obfuscation? 


3.25.2 Unsized array in C structure 


In some win32 structures we can find ones with last field defined as an array of one 
element: 


typedef struct _SYMBOL_INFO { 
ULONG SizeOfStruct; 
ULONG  TypeIndex; 


ULONG MaxNameLen; 
TCHAR Name[1]; 
} SYMBOL_INFO, *PSYMBOL_INFO; 


( https://msdn.microsoft.com/en-us/library/windows/desktop/ms680686 (v= 
vs.85).aspx) 


This is a hack, meaning, the last field is array of unknown size, which is to be calcu- 
lated at the time of structure allocation. 


Why: Name field may be short, so why to define it with some kind of MAX NAME 
constant which can be 128, 256, or even bigger? 


Why not to use pointer instead? Then you have to allocate two blocks: one for 
structure and the other one for string. This may be slower and may require larger 
memory overhead. Also, you need dereference pointer (i.e., read address of the 
string from the structure)—not a big deal, but some people say this is still surplus 
cost. 


This is also known as struct hack: http://c- faq.com/struct/structhack.html. 
Example: 


#include <stdio.h> 


struct st 

{ 
int a; 
int b; 
char s[]; 
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y 
void f (struct st *s) 
{ 
printf ("%d %d %s\n", s-»a, s->b, S->S); 
// f() can't replace s[] with bigger string - size of allocated block 
is unknown at this point 
F 
int main() 


{ 
#define STRING "Hello!" 
struct st *s=malloc(sizeof(struct st)+strlen(STRING)+1); // incl. 
terminating zero 
s->a=1; 
s->b=2; 
strcpy (s->s, STRING); 
f(s); 
i 


In short, it works because C has no array boundary checks. Any array is treated as 
having infinite size. 


Problem: after allocation, the whole size of allocated block for structure is unknown 
(except for memory manager), so you can’t just replace string with larger string. 
You would still be able to do so if the field would be declared as something like 
s[MAX_NAME]. 


In other words, you have a structure plus an array (or string) fused together in the 
single allocated memory block. Another problem is what you obviously can’t declare 
two such arrays in single structure, or to declare another field after such array. 


Older compilers require to declare array with at least one element: s[1], newer allows 
to declare it as variable-sized array: s[]. This is also called flexible array member in 
C99 standard. 


Read more about it in GCC documentation^?, MSDN documentation^?., 


Dennis Ritchie (one of C creators) called this trick “unwarranted chumminess with 
the C implementation" (perhaps, acknowledging hackish nature of the trick). 


Like it or not, use it or not: it is still another demonstration on how structures are 
stored in memory, that's why | write about it. 


3.25.3 Version of C structure 


Many Windows programmers have seen this in MSDN: 


SizeOfStruct 
The size of the structure, in bytes. This member must be set to sizeof (2 
Y SYMBOL INFO). 


48https://gcc.gnu.org/onlinedocs/gcc/Zero-Length.html 
49https://msdn.microsoft.com/en-us/library/b6fae073.aspx 
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( https://msdn.microsoft.com/en-us/library/windows/desktop/ms680686 (v= 
vs.85).aspx) 


Some structures like SYMBOL INFO has started with this field indeed. Why? This is 
some kind of structure version. 


Imagine you have a function which draws circle. It takes a single argument—a 
pointer to a structure with only three fields: X, Y and radius. And then color dis- 
plays flooded a market, sometimes in 1980s. And you want to add color argument 
to the function. But, let's say, you cannot add another argument to it (a lot of soft- 
ware use your API”? and cannot be recompiled). And if the old piece of software 
uses your API with color display, let your function draw a circle in (default) black and 
white colors. 


Another day you add another feature: circle now can be filled, and brush type can 
be set. 


Here is one solution to the problem: 


#include <stdio.h> 


struct verl 


{ 
size t SizeOfStruct; 
int coord X; 
int coord Y; 
int radius; 
yi 
struct ver2 
{ 
size t SizeOfStruct; 
int coord X; 
int coord Y; 
int radius; 
int color; 
ur 
struct ver3 
1 
size t SizeOfStruct; 
int coord X; 
int coord Y; 
int radius; 
int color; 
int fill brush type; // 0 - do not fill circle 
ur 


void draw circle(struct ver3 *s) // latest struct version is used here 


1 
// 
we presume SizeOfStruct, coord X and coord Y fields are always present 


50 Application Programming Interface 
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printf ("We are going to draw a circle at %d:%d\n", s->coord X, s-»7 


y coord Y); 


if (s-»SizeOfStruct»-sizeof(int)*5) 


1 


// this is at least ver2, 
printf ("We are going to set color %d\n", s-»color); 


) 


if (s-»SizeOfStruct»-sizeof(int)*6) 


{ 


// this is at least ver3, 


color field is present 


fill brush type field is present 


printf ("We are going to fill it using brush type %d\n", sv 


y -»fill brush type); 
} 
}; 


// early software version 

void call as verl() 

1 
struct verl s; 
s.SizeOfStruct=sizeof(s); 
s.coord X=123; 
s.coord Y=456; 
s.radius-10; 


printf ("** %s()\n", _ FUNCTION ); 


draw circle(&s) 
$; 


// next software version 

void call_as ver2() 

1 
struct ver2 s; 

.SizeO0fStruct=sizeof(s); 

.coord X-123; 

.coord Y=456; 

. radius=10; 

.color-1; 


nnnnun 


printf ("** %s()\n", _ FUNCTION ); 


draw circle(&s) 
Hh 


// latest, the most extended version 

void call as ver3() 

1 
struct ver3 s; 
s.SizeOfStruct=sizeof(s); 
s.coord X=123; 
s.coord Y=456; 
s.radius=10; 
s.color=1; 

s.fill_brush_type=3; 

p 


rintf ("** %s()\n", FUNCTION); 
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draw circle(&s); 


y; 

int main() 

1 
call as ver1(); 
call as ver2(); 
call as ver3(); 

y; 


In other words, SizeOfStruct field takes a role of version of structure field. It could 
be enumerate type (1, 2, 3, etc.), but to set SizeOfStruct field to sizeof(struct...) is 
less prone to mistakes/bugs: we just write s.SizeOfStruct-sizeof(...) in caller's code. 


In C++, this problem is solved using inheritance (3.21.1 on page 690). You just 
extend your base class (let's call it Circle), and then you will have ColoredCircle and 
then FilledColoredCircle, and so on. A current version of an object (or, more precisely, 
current type) will be determined using C++ RTTI. 


So when you see SizeOfStruct somewhere in MSDN-— perhaps this structure was ex- 
tended at least once in past. 


3.25.4 High-score file in “Block out" game and primitive seri- 
alization 


Many videogames has high-score file, sometimes called "Hall of fame". Ancient 
"Block out"?! game (3D tetris from 1989) isn't exception, here is what we see at the 
end: 


Start Game 


Figure 3.4: High score table 


51http://www. bestoldgames.net/eng/old-games/blockout.php 
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Now we can see that the file has changed after we added our name is BLSCORE.DAT. 


% xxd -g 1 BLSCORE.DAT 


00000000: 0a 00 58 65 6e 69 61 2e 2e 2e 2e 2e 00 df 01 00 ..Xenia......... 
00000010: 00 30 33 2d 32 37 2d 32 30 31 38 00 50 61 75 6c .03-27-2018.Paul 
00000020: 2e 2e 2e 2e 2e 2e 00 61 01 00 00 30 33 2d 32 37 ....... a...03-27 
00000030: 2d 32 30 31 38 00 4a 6f 68 6e 2e 2e 2e 2e 2e 2e -2018.John...... 
00000040: 00 46 01 00 00 30 33 2d 32 37 2d 32 30 31 38 00 .F...03-27-2018. 
00000050: 4a 61 6d 65 73 2e 2e 2e 2e 2e 00 44 01 00 00 30 James...... D...0 
00000060: 33 2d 32 37 2d 32 30 31 38 00 43 68 61 72 6c 69 3-27-2018.Charli 
00000070: 65 2e 2e 2e 00 ea 00 00 00 30 33 2d 32 37 2d 32 e........ 03-27-2 
00000080: 30 31 38 00 4d 69 6b 65 2e 2e 2e 2e 2e 2e 00 b5 018.Mike........ 
00000090: 00 00 00 30 33 2d 32 37 2d 32 30 31 38 00 50 68 ...03-27-2018.Ph 
00000020: 69 6c 2e 2e 2e 2e 2e 2e 00 ac 00 00 00 30 33 2d il........... 03- 
000000b0: 32 37 2d 32 30 31 38 00 4d 61 72 79 2e 2e 2e 2e 27-2018.Mary.... 
000000c0: 2e 2e 00 7b 00 00 00 30 33 2d 32 37 2d 32 30 31 ...1(...03-27-201 
000000d0: 38 00 54 6f 6d 2e 2e 2e 2e 2e 2e 2e 00 77 00 00 8.Tom........ W.. 
000000e0: 00 30 33 2d 32 37 2d 32 30 31 38 00 42 6f 62 2e .03-27-2018.Bob. 
000000f0: 2e 2e 2e 2e 2e 2e 00 77 00 00 00 30 33 2d 32 37 ....... w...03-27 
00000100: 2d 32 30 31 38 00 -2018. 


All entries are clearly visible. The very first byte is probably number of entries. Sec- 
ond is zero and, in fact, number of entries can be 16-bit value spanning over first 
two bytes. 


Next, after “Xenia” name we see OxDF and 0x01 bytes. Xenia has score of 479, and 
this is exactly Ox1DF in hexadecimal radix. So a high score value is probably 16-bit 
integer, or maybe 32-bit integer: there are two more zero bytes after. 


Now let’s think about the fact that both array elements and structure elements are 
always placed in memory adjacently to each other. That enables us to write the 
whole array/structure to the file using simple write() or fwrite() function, and then 
restore it using read() or fread(), as simple as that. This is what is called serialization 
nowadays. 


Read 


Now let's write C program to read highscore file: 


#include <assert.h> 
#include <stdio.h> 
#include <stdint.h> 
#include <string.h> 


struct entry 
{ 
char name[11]; // incl. terminating zero 
uint32_t score; 
char date[11]; // incl. terminating zero 
} attribute  ((aligned (1),packed)); 


struct highscore file 
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uint8 t count; 
uint8 t unknown; 
struct entry entries[10]; 
} attribute  ((aligned (1), packed)); 


struct highscore file file; 


int main(int argc, char* argv[]) 
1 
FILE* f=fopen(argv[1], "rb"); 
assert (f!zNULL); 
size t got-fread(&file, 1, sizeof(struct highscore file), f); 
assert (got--sizeof(struct highscore file)); 
fclose(f); 
for (int i20; i<file.count; i++) 
1 
printf ("name=%s score=%d date=%s\n", 
file.entries[i].name, 
file.entries[i].score, 
file.entries[i].date); 
Fs 
}; 


We need GCC ((aligned (1),packed)) attribute so that all structure fields will be packed 
on 1-byte boundary. 


Of course it works: 


name=Xenia..... score=479 date=03-27-2018 
name=Paul...... score=353 date=03-27-2018 
name=John...... score=326 date=03-27-2018 
name-James..... score=324 date=03-27-2018 
name=Charlie... score=234 date=03-27-2018 
name=Mike...... score=181 date=03-27-2018 
name=Phil...... score=172 date=03-27-2018 
name=Mary...... score=123 date=03-27-2018 
name-Tom....... score=119 date=03-27-2018 
name=Bob....... score=119 date=03-27-2018 


(Needless to say, each name is padded with dots, both on screen and in the file, 
perhaps, for aesthetical reasons.) 


Write 


Let’s check if we right about width of score value. Is it really has 32 bits? 


int main(int argc, char* argv[]) 
{ 
FILE* f=fopen(argv[1], "rb"); 
assert (f!=NULL); 
size t got=fread(&file, 1, sizeof(struct highscore file), f); 
assert (got==sizeof(struct highscore file)); 
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fclose(f); 


strcpy (file.entries[1].name, "Mallory..."); 
file.entries[1] .score=12345678; 
strcpy (file.entries[1].date, "08-12-2016"); 


f=fopen(argv[1], "wb"); 
assert (f!=NULL); 
got-fwrite(&file, 1, sizeof(struct highscore file), f); 
assert (got--sizeof(struct highscore file)); 
fclose(f); 
}; 


Let's run Blockout: 


Figure 3.5: High score table 


First two digits (1 and 2) are truncated: 12345678 becomes 345678. Perhaps, this is 
formatting issues... but the number is almost correct. Now I’m changing it to 999999 
and run again: 
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Figure 3.6: High score table 


Now it's correct. Yes, high score value is 32-bit integer. 


Is it serialization? 


...almost. Serialization like this is highly popular in scientific and engineering soft- 
ware, where efficiency and speed is much more important than converting into XML”? 
or JSON?? and back. 


One important thing is that you obviously cannot serialize pointers, because each 
time you load the file into memory, all the structures may be allocated in different 
places. 


But: if you work on some kind of low-cost MCU with simple OS on it and you have 
your structures allocated at always same places in memory, perhaps you can save 
and restore pointers as well. 


Random noise 


When | prepared this example, | had to run "Block out" many times and played for 
it a bit to fill high-score table with random names. 


And when there were just 3 entries in the file, | saw this: 


00000000: 03 00 54 6f 6d 61 73 2e 2e 2e 2e 2e 00 da 2a 00 ..Tomas....... ur 
00000010: 00 30 38 2d 31 32 2d 32 30 31 36 00 43 68 61 72 .08-12-2016.Char 
00000020: 6c 69 65 2e 2e 2e 00 8b le 00 00 30 38 2d 3132 lie........ 08-12 
00000030: 2d 32 30 31 36 00 4a 6f 68 Ge 2e 2e 2e 2e 2e 2e -2016.John...... 
00000040: 00 80 00 00 00 30 38 2d 31 32 2d 32 30 31 36 00 ..... 08-12-2016. 
00000050: 00 00 57 c8 a2 01 06 01 ba f9 47 c7 05 00 f8 4f ..W....... G....0 
00000060: 06 01 06 01 a6 32 00 00 00 00 00 00 00 00 00 00 ..... Li id 


00000070: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO ................ 
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00000080: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO ................ 
00000090: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO ................ 
00000020: 00 00 00 00 00 00 00 00 00 00 93 c6 a2 01 46 72 .............. Fr 
000000b0: 8c f9 f6 c5 05 00 f8 4f 00 02 06 01 a6 32 06 O1 ....... 0 sis 255 
000000c0: 00 00 98 f9 f2 cO 05 00 f8 4f 00 02 a6 32 a2 f9 ......... 0... 
000000d0: 80 cl a6 32 a6 32 f4 4f aa f9 39 cl a6 32 06 01 ...2. 
000000e0: b4 f9 2b c5 a6 32 el 4f c7 c8 a2 01 82 72 c6 f9 ..+.. $ 
000000f0: 30 cO 05 00 00 00 00 00 00 00 ab 32 d4 f9 76 2d 0.......... 2..V- 
00000100: a6 32 00 00 00 00 222923 


The first byte has value of 3, meaning there are 3 entries. And there are 3 entries 
present. But then we see a random noise at the second half of file. 


The noise is probably has its origins in uninitialized data. Perhaps, "Block out" allo- 
cated memory for 10 entries somewhere in heap, where, obviously, some pseudo- 
random noise (left from something else) was present. Then it set first/second byte, 
fill 3 entries, and then it never touched 7 entries left, so they are written to the file 
as is. 


When "Block out" loads high score file at the next run, it reads number of entries 
from the first/second byte (3) and then completely ignores what is after it. 


This is common problem. Not a problem in strict sense: it's not a bug, but information 
can be exposed outwards. 


Microsoft Word versions from 1990s has been often left pieces of previously edited 
texts into the *.doc* files. It was some kind of amusement back then, to get a .doc 
file from someone, then open it in a hexadecimal editor and read something else, 
what has been edited on that computer before. 


The problem can be even much more serious: Heartbleed bug in OpenSSL. 


Homework 


"Block out" has several polycubes (flat/basic/extended), size of pit can be configured, 
etc. And it seems, for each configuration, "Block out" has its own high score table. 
l've noticed that some information is probably stored in BLSCORE.IDX file. This can 
be a homework for hardcore "Block out" fans—to understand its structure as well. 


The "Block out" files are here: http://beginners.re/examples/blockout.zip (in- 
cluding the binary high score files l've used in this example). You can use DosBox to 
run it. 


3.26 memmove() and memcpy() 


The difference between these standard functions is that memcpy() blindly copies a 
block to another place, while memmove() correctly handles overlapping blocks. For 
example, you want to tug a string two bytes back: 


"p.p. |hleltltio]...^ -» "[hieltitio]...^ 
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memcpy() which copies 32-bit or 64-bit words at once, or even SIMD, will obviously 
fail here, a byte-wise copy routine must be used instead. 


Now even more advanced example, insert two bytes in front of string: 


"Ihle]t[t]o]...^ -» "|. |. |hleltlt[o]...^ 


Now even byte-wise memory copy routine will fail, you have to copy bytes starting 
at the end. 


That's a rare case where DF x86 flag is to be set before REP MOVSB instruction: DF 
defines direction, and now we must move backwardly. 


The typical memmove() routine works like this: 1) if source is below destination, 
copy forward; 2) if source is above destination, copy backward. 


This is memmove() from uClibc: 


void *memmove(void *dest, const void *src, size t n) 


1 
int eax, ecx, esi, edi; 
. asm  J volatile ( 
" movl %%eax, %%edi\n" 
» cmpl %%esi, %%eax\n" 
7 je 2f\n" /* (optional) src == dest -> NOP */ 
: jb 1f\n" /* src > dest -> simple copy */ 
” leal -1(%%esi,%%ecx), %%esi\n" 
" leal -l(995eax,?8secx), %%edi\n" 
> std\n" 
"1s rep; movsb\n" 
" cld\n" 
"2:\n" 
"z&c" (ecx), "=&S" (esi), "=G&a" (eax), "-&D" (edi) 
"Q" (n), "1" (src), "2" (dest) 
"memory" 
); 
return (void*)eax; 
} 


In the first case, REP MOVSB is called with DF flag cleared. In the second, DF is set, 
then cleared. 


More complex algorithm has the following piece in it: 


“if difference between source and destination is larger than width of word, copy using 
words rather than bytes, and use byte-wise copy to copy unaligned parts”. 


This how it happens in Glibc 2.24 in non-optimized C part. 


Given all that, memmove() may be slower than memcpy(). But some people, in- 
cluding Linus Torvalds, argue?^ that memcpy() should be an alias (or synonym) of 
memmove(), and the latter function must just check at start, if the buffers are over- 
lapping or not, and then behave as memcpy() or memmove(). Nowadays, check for 
overlapping buffers is very cheap, after all. 


9Ahttps://bugzilla.redhat.com/show bug.cgi?id-6384774$c132 
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3.26.1 Anti-debugging trick 


l've heard about anti-debugging trick where all you need is just set DF to crash the 
process: the very next memcpy() routine will lead to crash because it copies back- 
wardly. But | can't check this: it seems all memory copy routines clear/set DF as they 
wantto. On the other hand, memmove() from uClibc cited here, has no explicit clear 
of DF (it assumes DF is always clear?), so it can really crash. 


3.27 setjmp/longjmp 


setjmp/longjmp is a mechanism in C which is very similar to throw/catch mechanism 
in C++ and other higher-level PLs. Here is an example from zlib: 


/* return if bits() or decode() tries to read past available input */ 


if (setjmp(s.env) !- 0) /* if came back here via longjmp(), 
G * / 

err = 2; /* then skip decomp(), return 2 
error */ 
else 


err = decomp(&s); /* decompress */ 


/* load at least need bits into val */ 
val = s->bitbuf; 
while (s->bitcnt < need) { 


if (s->left == 0) { 

s->left = s->infun(s->inhow, &(s->in)); 

if (s->left == 0) longjmp(s->env, 1); /* out of input */ 
if (s->left == 0) { 

s->left = s->infun(s->inhow, &(s->in)); 

if (s->left == 0) longjmp(s->env, 1); /* out of input */ 


( zlib/contrib/blast/blast.c ) 


Call to setjmp() saves current PC, SP and other registers into env structure, then it 
returns 0. 


In case of error, Longjmp() teleporting you into the point after right after setjmp() 
call, as if setjmp() call returned non-null value (which was passed to Longjmp()). 
This reminds as fork() syscall in UNIX. 


Now let's take a look on distilled example: 


#include <stdio.h> 
#include <setjmp.h> 


jmp_buf env; 
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void f2() 
1 
printf ("%s() begin\n", _ FUNCTION ); 
// something odd happened here 
longjmp (env, 1234); 
printf ("%s() end\n", _ FUNCTION ); 


}; 
void f1() 
{ 
printf ("%s() begin\n", _ FUNCTION ); 
f2(); 
printf ("%s() end\n", _ FUNCTION ); 
}; 
int main() 
{ 
int errzsetjmp(env); 
if (err--0) 
1 
f1(); 
} 
else 
{ 
printf ("Error %d\n", err); 
h 
}; 


If we run it, we will see: 


f1() begin 
f2() begin 
Error 1234 


jmp_buf structure usually comes undocumented, to preserve forward compatibility. 
Let's see how setjmp() implemented in MSVC 2013 x64: 


; RCX = address of jmp buf 


mov [rcx], rax 

mov [rcx+8], rbx 
mov [rcx+18h], rbp 
mov [rex+20h], rsi 
mov [rex+28h], rdi 
mov [rcx+30h], r12 
mov [rcx+38h], r13 
mov [rcx+40h], r14 
mov [rcx+48h], r15 
lea r8, [rsptarg 0] 
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mov [rcx+10h], r8 
mov r8, [rsp+0] ; get saved RA from stack 
mov [rcx+50h], r8 ; Save it 


stmxcsr dword ptr [rcx+58h] 

fnstcw word ptr [rcx+5Ch] 

movdqa xmmword ptr [rcx+60h], xmm6 
movdga xmmword ptr [rcx+70h], xmm7 
movdqa xmmword ptr [rcx+80h], xmm8 
movdqa xmmword ptr [rcx+90h], xmm9 
movdqa xmmword ptr [rcx+0A0h], xmm10 
movdqa xmmword ptr [rcx+0B0h], xmm11 
movdga xmmword ptr [rcx+0C0h], xmm12 
movdqa xmmword ptr [rcx+0D0Oh], xmm13 
movdqa xmmword ptr [rcx+0E0h], xmm14 
movdqa xmmword ptr [rcx+0FOh], xmm15 
retn 


It just populates jmp buf structure with current values of almost all registers. Also, 
current value of RA is taken from the stack and saved in jmp buf: it will be used as 
new value of PC in future. 


Now longjmp(): 


; RCX = address of jmp buf 


mov rax, rdx 

mov rbx, [rcx+8] 

mov rsi, [rcx+20h] 

mov rdi, [rcx+28h] 

mov r12, [rcx+30h] 

mov r13, [rcx+38h] 

mov r14, [rcx+40h] 

mov r15, [rcx+48h] 
ldmxcsr dword ptr [rcx+58h] 
fnclex 


fldcw word ptr [rcx+5Ch] 

movdqa xmm6, xmmword ptr [rcx+60h] 
movdqa xmm7, xmmword ptr [rcx+70h] 
movdqa xmm8, xmmword ptr [rcx+80h] 
movdqa xmm9, xmmword ptr [rcx+90h] 
movdqa xmm10, xmmword ptr [rcx+0A0h] 
movdga xmmll, xmmword ptr [rcx+0B0h] 
movdga xmm12, xmmword ptr [rcx+0C0h] 
movdga xmm13, xmmword ptr [rcx+0D0h] 
movdqa xmml14, xmmword ptr [rcx+0E0h] 
movdqa xmm15, xmmword ptr [rcx+0FOh] 


mov rdx, [rcx+50h] ; get PC (RIP) 

mov rbp, [rcx+18h] 

mov rsp, [rcx+10h] 

jmp rdx ; jump to saved PC 
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It just restores (almost) all registers, takes RA from structure and jumps there. This 
effectively works as if setjmp() returned to caller. Also, RAX is set to be equal to the 
second argument of longjmp(). This works as if setjmp() returned non-zero value at 
first place. 


As a side effect of SP restoration, all values in stack which has been set and used be- 
tween setjmp() and longjmp() calls are just dropped. They will not be used anymore. 
Hence, longjmp() usually jumps backwards °°. 


This implies that, unlike in throw/catch mechanism in C++, no memory will be freed, 
no destructors will be called, etc. Hence, this technique sometimes can be danger- 
ous. Nevertheless, it's still quite popular. It's still used in Oracle RDBMS. 


It also has unexpected side-effect: if some buffer has been overflown inside of a 
function (maybe due to remote attack), and a function wants to report error, and it 
calls longjmp(), overwritten stack part just gets unused. 


As an exercise, you can try to understand, why not all registers are saved. Why 
XMMO-XMM5 and other registers are skipped? 


3.28 Other weird stack hacks 


3.28.1 Accessing arguments/local variables of caller 


From C/C++ basics we know that this is impossible for a function to access argu- 
ments of caller function or its local variables. 


Nevertheless, it's possible using dirty hacks. For example: 


#include <stdio.h> 


void f(char *text) 


{ 
// print stack 
int *tmp=&text; 
for (int i=0; i<20; i++) 
{ 
printf ("Ox%x\n", *tmp); 
tmp++; 
un 
ur 


void draw text(int X, int Y, char* text) 


1 
f(text); 


printf ("We are going to draw [%s] at %Sd:%d\n", text, X, Y); 


55However, there are some people who can use it for much more complicated things, imitating corou- 
tines, etc: https://www.embeddedrelated.com/showarticle/455.php, http://fanf.livejournal. 
com/105413.html 
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$; 

int main() 

1 
printf ("address of main()=0x%x1n", &main); 
printf ("address of draw_text()=0x%x\n", &draw text); 
draw text(100, 200, "Hello!"); 

$; 


On 32-bit Ubuntu 16.04 and GCC 5.4.0, | got this: 


address of main()=0x80484f8 

address of draw_text()=0x80484cb 

0x8048645 first argument to f() 
0x8048628 

Oxbfd8ab98 

0xb7634590 

0xb779eddc 

0xb77e4918 

Oxbfd8aba8 

0x8048547 return address into the middle of main() 
0x64 first argument to draw text() 
0xc8 second argument to draw text() 
0x8048645 third argument to draw text() 
0x8048581 

0xb779d3dc 

Oxbfd8abcO 

0x0 

0xb7603637 

0xb779d000 

0xb779d000 

0x0 

0xb7603637 


(Comments are mine.) 


Since f() starting to enumerate stack elements at its first argument, the first stack 
element is indeed a pointer to "Hello!" string. We see its address is also used as 
third argument to draw text() function. 


In f() we could read all functions arguments and local variables if we know exact stack 
layout, but it's always changed, from compiler to compiler. Various optimization 
levels affect stack layout greatly. 


But if we can somehow detect information we need, we can use it and even modify 
it. As an example, l'Il rework f() function: 


void f(char *text) 


{ 


// find 100, 200 values pair and modify the second on 
tmp=&text ; 
for (int i=0; i<20; i++) 
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1 
if (*tmp==100 && *(tmp+1)==200) 
{ 
printf ("found\n"); 
*(tmp+1)=210; // change 200 to 210 
break; 
}; 
tmp++; 
un 


ur 


Holy moly, it works: 


found 
We are going to draw [Hello!] at 100:210 


Summary 


It's extremely dirty hack, intended to demonstrate stack internals. | never ever seen 
or heard that anyone used this in a real code. But still, this is a good example. 


Exercise 


The example has been compiled without optimization on 32-bit Ubuntu using GCC 
5.4.0 and it works. But when | turn on -03 maximum optimization, it's failed. Try to 
find why. 


Use your favorite compiler and OS, try various optimization levels, find if it works 
and if it doesn't, find why. 
3.28.2 Returning string 


This is classic bug from Brian W. Kernighan, Rob Pike, Practice of Programming, 
(1999): 


#include <stdio.h> 


char* amsg(int n, char* s) 


{ 
char buf[100]; 
sprintf (buf, "error %d: %s\n", n, S) ; 
return buf; 
}; 
int main() 
{ 
printf ("%s\n", amsg (1234, "something wrong!")); 
}; 
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It would crash. First, let's understand, why. 


This is a stack state before amsg() return: 


(lower addresses) 


[amsg(): 100 bytes] 

[RA] «- current SP 
[two amsg arguments] 

[something else] 

[nain() local variables] 


(upper addresses) 


When amsg() returns control flow to main(), so far so good. But printf() is called 
from main(), which is, in turn, use stack for its own needs, zapping 100-byte buffer. 
A random garbage will be printed at the best. 


Hard to believe, but | know how to fix this problem: 


#include <stdio.h> 


char* amsg(int n, char* s) 


{ 
char buf[100]; 
sprintf (buf, "error %d: %s\n", n, S) ; 
return buf; 
}; 
char* interim (int n, char* s) 
{ 
char large buf[8000]; 
// make use of local array. 
// it will be optimized away otherwise, as useless. 
large buf[0]=0; 
return amsg (n, s); 
}; 
int main() 
{ 
printf ("%s\n", interim (1234, “something wrong!")); 
}; 


It will work if compiled by MSVC 2013 with no optimizations and with /GS- option°®. 
MSVC will warn: "warning C4172: returning address of local variable or temporary", 


56Turn off buffer security check 
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but the code will run and message will be printed. Let's see stack state at the mo- 
ment when amsg() returns control to interim(): 


(lower addresses) 


[amsg(): 100 bytes] 

[RA] «- current SP 
[two amsg() arguments] 

[interim() stuff, incl. 8000 bytes] 

[something else] 

[nain() local variables] 


(upper addresses) 


Now the stack state at the moment when interim() returns control to main(): 


(lower addresses) 


[amsg(): 100 bytes] 

[RA] 

[two amsg() arguments] 

[interim() stuff, incl. 8000 bytes] 

[something else] «- current SP 
[main() local variables] 


(upper addresses) 


So when main() calls printf(), it uses stack at the place where interim()'s buffer 
was allocated, and doesn't zap 100 bytes with error message inside, because 8000 
bytes (or maybe much less) is just enough for everything printf() and other de- 
scending functions do! 


It may also work if there are many functions between, like: main() > f1() > f20 > 
f3() ... + amsg(), and then the result of amsg() is used in main(). The distance 
between SP in main() and address of buf[] must be long enough, 


This is why bugs like these are dangerous: sometimes your code works (and bug can 
be hiding unnoticed), sometimes not. Bugs like these are jokingly called heisenbugs 
or schródinbugs. 


3.29 OpenMP 


OpenMP is one of the simplest ways to parallelize simple algorithms. 
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As an example, let's try to build a program to compute a cryptographic nonce. 


In my simplistic example, the nonce is a number added to the plain unencrypted 
text in order to produce a hash with some specific features. 


For example, at some step, the Bitcoin protocol requires to find such nonce so the 
resulting hash contains a specific number of consecutive zeros. This is also called 
proof of work (i.e., the system proves that it did some intensive calculations and 
spent some time for it). 


My example is not related to Bitcoin in any way, it will try to add numbers to the 
"hello, world! " string in order to find such number that when "hello, world! <number> 
is hashed with the SHA512 algorithm, it will contain at least 3 zero bytes. 


Let's limit our brute-force to the interval in O..INT32 MAX-1 (i.e., Ox7FFFFFFE or 
2147483646). 


The algorithm is pretty straightforward: 


” 


#include <stdio.h> 
#include <string.h> 
#include <stdlib.h> 
#include <time.h> 

#include "sha512.h" 


int found=0; 
int32_t checked=0; 


int32 t* min; 
int32 t* max; 


time t start; 
#ifdef | GNUC — 
#define min(X,Y 
#define max(X,Y) ((X) 
#endif 


void check_nonce (int32 t nonce) 
1 
uint8 t buf[32]; 
struct sha512 ctx ctx; 
uint8 t res[64]; 


// update statistics 
int t-omp get thread num(); 


if (_ min[t]---1) 

. min[t]=nonce; 
if (__max[t]==-1) 

. max[t]=nonce; 


. min[t]-min( min[t], nonce); 
. max[t]=max(__max[t], nonce); 
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// idle if valid nonce found 
if (found) 
return; 


memset (buf, 0, sizeof(buf)); 
sprintf (buf, "hello, world! %d", nonce); 


sha512 init ctx (&ctx); 

sha512 process bytes (buf, strlen(buf), &ctx); 
sha512 finish ctx (&ctx, &res); 

if (res[0]==0 && res[1]==0 && res[2]==0) 

{ 


printf ("found (thread %d): [95s]. seconds spent=%d\n", t, 2 
G buf, time(NULL)-start); 
found=1; 
$; 
#pragma omp atomic 
checked++; 


#pragma omp critical 
if ((checked % 100000)==0) 
printf ("checked=%d\n", checked); 
yi 


int main() 

{ 
int32 t i; 
int threads=omp_get_max_threads(); 
printf ("threads=%d\n", threads); 


min=(int32_t*)malloc(threads*sizeof(int32_t)); 
. max=(int32_t*)malloc(threads*sizeof(int32_t)); 
for (i=0; i<threads; i++) 

. min[i]- _max[i]=-1; 


start-time(NULL); 


#pragma omp parallel for 
for (i20; i«INT32 MAX; i++) 
check nonce (i); 


for (i20; i<threads; i++) 
printf ("__min[%d]=0x%08x — max[%d]=O0x%08x\n", i, _ min[i],/ 
GS i,  max[il); 


free( min); free( max); 


yi 


The check_nonce() function just adds a number to the string, hashes it with the 
SHA512 algorithm and checks for 3 zero bytes in the result. 


A very important part of the code is: 


#pragma omp parallel for 
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for (i20; i«INT32 MAX; i++) 
check nonce (i); 


Yes, that simple, without #pragma we just call check nonce() for each number from 
O to INT32 MAX (0x7fffffff or 2147483647). With #pragma, the compiler adds 
some special code which slices the loop interval into smaller ones, to run them on 
all CPU cores available ?7. 


The example can be compiled °° in MSVC 2012: 


cl openmp example.c sha512.0bj /openmp /01 /Zi /Faopenmp example.asm 


Or in GCC: 


gcc -fopenmp 2.c sha512.c -S -masm=intel 


3.29.1 MSVC 
Now this is how MSVC 2012 generates the main loop: 
Listing 3.125: MSVC 2012 


push OFFSET main$omp$1 


push 0 

push 1 

call . vcomp fork 
add esp, 16 


All functions prefixed by vcomp are OpenMP-related and are stored in the vcomp*.dll 
file. So here a group of threads is started. 


Let's take a look on. main$omp$1: 


Listing 3.126: MSVC 2012 


$T1 - -8 ; size = 4 
$T2 = -4 ; size = 4 
 main$omp$1 PROC 
push ebp 
mov ebp, esp 
push ecx 
push ecx 
push esi 
lea eax, DWORD PTR $T2[ebp] 
push eax 
lea eax, DWORD PTR $Tl[ebp] 
push eax 
push 1 
push 1 


57N.B.: This is intentionally simplest possible example, but in practice, the usage of OpenMP can be 
harder and more complex 

38sha512.(c|h) and u64.h files can be taken from the OpenSSL library: http://www.openssl.org/ 
source/ 
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push 2147483646 ; TffffffeH 

push 0 

call vcomp for static simple init 

mov esi, DWORD PTR $T1[ebp] 

add esp, 24 

jmp SHORT $LN6@main$omp$1 
$LL2@main$omp$1: 

push esi 

call _check_nonce 

pop ecx 

inc esi 
$LN6Emains$omp$1: 

cmp esi, DWORD PTR $T2[ebp] 

jte SHORT $LL2@main$omp$1 

call vcomp for static end 

pop esi 

leave 

ret 0 


 main$omp$1 ENDP 


This function is to be started n times in parallel, where n is the number of CPU cores. 
vcomp for static simple init() calculates the interval for the for() construct for 
the current thread, depending on the current thread's number. 


The loop's start and end values are stored in the $T1 and $T2 local variables. You may 
also notice 7ffffffeh (or 2147483646) as an argumenttothe vcomp for static simple init() 
function—this is the number of iterations for the whole loop, to be divided evenly. 


Then we see a new loop with a call to the check nonce() function, which does all 
the work. 


Let's also add some code at the beginning of the check nonce() function to gather 
statistics about the arguments with which the function has been called. 


This is what we see when we run it: 


threads=4 


checked=2800000 

checked=3000000 

checked=3200000 

checked=3300000 

found (thread 3): [hello, world! 1611446522]. seconds spent=3 
. min[0]-0x00000000 _max[0]=0x1fffffff 

^ min[1]-0x20000000 ^max[1]-0x3fffffff 

^ min[2]-0x40000000 ^ max[2]-0x5fffffff 

— min[3]=0x60000000 ^ max[3]-0x7ffffffe 


Yes, the result is correct, the first 3 bytes are zeros: 


C:\...\sha512sum test 
000000f4a8fac5a4ed38794da4c1e39f54279ad5d9bb3c5465cdf57adaf60403 
df6e3fe6019f5764fc9975e505a7395fed780fee50eb38dd4c0279cb114672e2 *test 
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The running time is « 2..3 seconds on 4-core Intel Xeon E3-1220 3.10 GHz. In the 
task manager we see 5 threads: 1 main thread + 4 more. No further optimizations 
are done to keep this example as small and clear as possible. But probably it can 
be done much faster. My CPU has 4 cores, that is why OpenMP started exactly 4 
threads. 


By looking at the statistics table we can clearly see how the loop has been sliced 
into 4 even parts. Oh well, almost even, if we don't consider the last bit. 


There are also pragmas for atomic operations. 


Let's see how this code is compiled: 


#pragma omp atomic 
checked++; 


#pragma omp critical 
if ((checked % 100000)==0) 
printf ("checked=%d\n", checked); 


Listing 3.127: MSVC 2012 


push edi 
push OFFSET checked 
call vcomp atomic add i4 
; Line 55 
push OFFSET $vcomp$critsect$ 
call vcomp enter critsect 
add esp, 12 
; Line 56 
mov ecx, DWORD PTR checked 
mov eax, ecx 
cdq 
mov esi, 100000 ; 000186a0H 
idiv esi 
test edx, edx 
jne SHORT $LNlecheck_nonc 
; Line 57 
push ecx 
push OFFSET ??_C@ OM@NPNHLIOO@checked?$DN?$CFd?6?$AAQ@ 
call _ printf 
pop ecx 
pop ecx 


$LN1Gcheck nonc: 
push DWORD PTR _$vcomp$critsect$ 
call vcomp leave critsect 
pop ecx 


As it turns out, the vcomp atomic add i4() function in the vcomp*.dll is just a tiny 
function with the LOCK XADD instruction”? in it. 


59Read more about LOCK prefix: .1.6 on page 1297 
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vcomp enter critsect() eventually calling win32 API function 
EnterCriticalSection() 99. 


3.29.2 GCC 


GCC 4.8.1 produces a program which shows exactly the same statistics table, 


so, GCC's implementation divides the loop in parts in the same fashion. 


Listing 3.128: GCC 4.8.1 


mov edi, OFFSET FLAT:main. omp fn.0 
call GOMP parallel start 

mov edi, 0 

call main. omp fn.0 


call GOMP parallel end 


Unlike MSVC's implementation, what GCC code does is to start 3 threads, and run 
the fourth in the current thread. So there are 4 threads instead of the 5 in MSVC. 


Here is the main. omp fn.0 function: 


Listing 3.129: GCC 4.8.1 


main. omp fn.0: 


push rbp 

mov rbp, rsp 

push rbx 

sub rsp, 40 

mov QWORD PTR [rbp-40], rdi 

call omp get num threads 

mov ebx, eax 

call omp get thread num 

mov esi, eax 

mov eax, 2147483647 ; Ox7FFFFFFF 

cdq 

idiv ebx 

mov ecx, eax 

mov eax, 2147483647 ; Ox7FFFFFFF 

cdq 

idiv ebx 

mov eax, edx 

cmp esi, eax 

jl .L15 
.L18: 

imul esi, ecx 

mov edx, esi 

add eax, edx 

lea ebx, [rax+rcx] 

cmp eax, ebx 

jge .L14 

mov DWORD PTR [rbp-20], eax 
.L17: 


60You can read more about critical sections here: 6.5.4 on page 1002 
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mov eax, DWORD PTR [rbp-20] 
mov edi, eax 
call check nonce 
add DWORD PTR [rbp-20], 1 
cmp DWORD PTR [rbp-20], ebx 
jt Eb 
jmp .L14 
.L15: 
mov eax, 0 
add ecx, 1 
jmp .L18 
.L14: 
add rsp, 40 
pop rbx 
pop rbp 
ret 


Here we see the division clearly: by calling 
omp get num threads() and omp get thread num() 


we get the number of threads running, and also the current thread's number, and 
then determine the loop's interval. Then we run check nonce(). 


GCC also inserted the LOCK ADD 


instruction right in the code, unlike MSVC, which generated a call to a separate DLL 
function: 


Listing 3.130: GCC 4.8.1 


lock add DWORD PTR checked[rip], 1 
call GOMP critical start 

mov ecx, DWORD PTR checked[rip] 

mov edx, 351843721 

mov eax, ecx 

imul edx 

sar edx, 13 

mov eax, ecx 

sar eax, 31 

sub edx, eax 

mov eax, edx 

imul eax, eax, 100000 

sub ecx, eax 

mov eax, ecx 

test eax, eax 

jne .L7 

mov eax, DWORD PTR checked[rip] 

mov esi, eax 

mov edi, OFFSET FLAT:.LC2 ; "checked=%d1n" 
mov eax, 0 


call printf 
L7: 
call GOMP critical end 
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The functions prefixed with GOMP are from GNU OpenMP library. Unlike vcomp*.dll, 
its source code is freely available: GitHub. 


3.30 Signed division using shifts 


Unsigned division by 2" numbers is easy, just use bit shift right by n. Signed division 
by 2* is easy as well, but some correction needs to be done before or after shift 
operation. 


First, most CPU architectures support two right shift operations: logical and arith- 
metical. During logical shift right, free bit(s) at left are set to zero bit(s). This is SHR 
in x86. During arithmetical shift right, free bit(s) at left are set equal to the bit which 
was at the same place. Thus, it preserves sign bit while shifting. This is SAR in x86. 


Interesting to know, there is no special instruction for arithmetical shift left, because 
it works just as logical shift left. So, SAL and SHL instructions in x86 are mapped to 
the same opcode. Many disassemblers don't even know about SAL instruction and 
decode this opcode as SHL. 


Hence, arithmetical shift right is used for signed numbers. For example, if you shift 
-4 (11111100b) by 1 bit right, logical shift right operation will produce 01111110b, 
which is 126. Arithmetical shift right will produce 11111110b, which is -2. So far so 
good. 


What if we need to divide -5 by 2? This is -2.5, or just -2 in integer arithmetic. -5 
is 11111011b, by shifting this value by 1 bit right, we'll get 11111101b, which is -3. 
This is slightly incorrect. 


Another example: -4 = -0.5 or just 0 in integer arithmetic. But -1 is 11111111b, and 


11111111b » 1 = 11111111b, which is -1 again. This is also incorrect. 
One solution is to add 1 to the input value if it's negative. 


That is why, if we compile x/2 expression, where x is signed int, GCC 4.8 will produce 
something like that: 


mov eax, edi 

shr eax, 31 ; isolate leftmost bit, which is 1 if the number is 
negative and 0 if positive 

add eax, edi ; add 1 to the input value if it's negative, do 
nothing otherwise 

sar eax ; arithmetical shift right by one bit 

ret 


If you divide by 4, 3 needs to be added to the input value if it’s negative. So this is 
what GCC 4.8 does for x/4: 


lea eax, [rdi+3] ; prepare x+3 value ahead of time 
test edi, edi 


; if the sign is not negative (i.e., positive), move input value to 


EAX 
; if the sign is negative, x+3 value is left in EAX untouched 


cmovns eax, edi 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


812 


; do arithmetical shift right by 2 bits 
sar eax, 2 
ret 


If you divide by 8, 7 will be added to the input value, etc. 
MSVC 2013 is slightly different. This is division by 2: 


mov eax, DWORD PTR a$[esp-4] 

; Sign-extend input value to 64-bit value into EDX:EAX 

; effectively, that means EDX will be set to OFFFFFFFFh if the input 
value is negative 

; ... or to 0 if positive 

cdq 

; subtract -1 from input value if it's negative 

; this is the same as adding 1 


sub eax, edx 

; do arithmetical shift right 
sar eax, 1 

ret 0 


Division by 4 in MSVC 2013 is little more complex: 


mov eax, DWORD PTR a$[esp-4] 

cdq 

; now EDX is OFFFFFFFFh if input value is negative 

; EDX is 0 if it's positive 

and edx, 3 

; now EDX is 3 if input is negative or 0 otherwise 

; add 3 to input value if it's negative or do nothing otherwise: 


add eax, edx 

; do arithmetical shift 
sar eax, 2 

ret 0 


Division by 8 in MSVC 2013 is similar, but 3 bits from EDX is taken instead of 2, 
producing correction value of 7 instead of 3. 


Sometimes, Hex-Rays 6.8 can’t handle such code correctly, and it may produce 
something like this: 


int v0; 


|. int64 v14 


v14 = ...; 
vO = ((signed int)v14 - HIDWORD(v14)) >> 1; 


. it can be safely rewritten to vO=v14/2. 


Hex-Rays 6.8 can also handle signed division by 4 like that: 


result = ((BYTE4(v25) & 3) + (signed int)v25) >> 2; 
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... can be rewritten to v25 / 4. 


Also, such correction code is used often when division is replaced by multiplication 
by magic numbers: read Mathematical Recipes?'about multiplicative inverse. And 
sometimes, additional shifting is used after multiplication. For example, when GCC 
optimizes 15, it can't find multiplicative inverse for 10, because diophantine equation 
has no solutions. So it generates code for = and then adds arithmetical shift right 
operation by 1 bit, to divide the result by 2. Of course, this is true only for signed 
integers. 


So here is division by 10 by GCC 4.8: 


mov eax, edi 

mov edx, 1717986919 ; magic number 

sar edi, 31 ; isolate leftmost bit (which reflects sign) 

imul edx ; multiplication by magic number (calculate 
x/5) 

sar edx, 2 ; now calculate (x/5)/2 


; subtract -1 (or add 1) if the input value is negative. 
; do nothing otherwise: 


sub edx, edi 
mov eax, edx 
ret 


Summary: 2” -1 must be added to input value before arithmetical shift, or 1 must be 
added to the final result after shift. Both operations are equivalent to each other, so 
compiler developers may choose what is more suitable to them. From the reverse 
engineer's point of view, this correction is a clear evidence that the value has signed 
type. 


3.31 Another heisenbug 


Sometimes, array (or buffer) can overflow due to fencepost error: 


#include <stdio.h> 


int array1[128]; 

int important varl; 
int important var2; 
int important var3; 
int important var4; 
int important var5; 


int main() 
1 
important varl-1; 
important var2-2; 
important var3-3; 


®lhttps://math. recipes 
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important var4-4; 
important var5-5; 


array1[0]=123; 
array1[128]2456; // BUG 


printf ("important_varl=%d\n", important varl); 
printf ("important_var2=%d\n", important_var2); 
printf ("important _var3=%d\n", important var3); 
printf ("important _var4=%d\n", important var4); 
printf ("important var5-*sdWAn", important var5); 


Fi 


This is what this program printed in my case (non-optimized GCC 5.4 x86 on Linux): 


important varl-1 
important var2-456 
important var3-3 
important var4-4 
important var5-5 


As it happens, important var2 has been placed by compiler right after array1[]: 


Listing 3.131: objdump -x 


08042040 g 0 .bss 00000200 arrayl 

0804a240 g O .bss 00000004 important_var2 
0804a244 g O .bss 00000004 important_var4 
0804a248 g O .bss 00000004 important_varl 
0804a24c g O .bss 00000004 important_var3 
0804a250 g 0 .bss 00000004 important_var5 


Another compiler can arrange variables in another order, and another variable would 
be zapped. This is also heisenbug (3.28.2 on page 803)—bug may appear or may 
left unnoticed depending on compiler version and optimization switches. 


If all variables and arrays are allocated in local stack, stack protection may be trig- 
gered, or may not. However, Valgrind can find bugs like these. 


Related example in the book (Angband game): 1.27 on page 379. 


3.32 The case of forgotten return 

Let’s revisit the “attempt to use the result of a function returning void” part: 1.15.1 
on page 137. 

This is a bug | once hit. 


And this is also yet another demonstration, how C/C++ places return value into 
EAX/RAX register. 


In the piece of code like that, | forgot to add return: 
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#include <stdio.h> 
#include <stdlib.h> 


struct color 


{ 
int R; 
int G; 
int B; 
$; 
struct color* create color (int R, int G, int B) 
1 
struct color* rt=(struct color*)malloc(sizeof(struct color)); 
rt->R=R; 
rt->G=G; 
rt->B=B; 
// must be "return rt;" here 
Fi 
int main() 
{ 
struct color* a=create color(1,2,3); 
printf ("%d %d %d\n", a->R, a->G, a->B); 
yi 


Non-optimizing GCC 5.4 silently compiles this with no warnings. And the code works! 
Let's see, why: 


Listing 3.132: Non-optimizing GCC 5.4 


create color: 


push rbp 

mov rbp, rsp 

sub rsp, 32 

mov DWORD PTR [rbp-20], edi 
mov DWORD PTR [rbp-24], esi 
mov DWORD PTR [rbp-28], edx 
mov edi, 12 

call malloc 


; RAX = pointer to newly allocated buffer 


, 


now fill it with R/G/B: 


mov QWORD PTR [rbp-8], rax 
mov rax, QWORD PTR [rbp-8] 
mov edx, DWORD PTR [rbp-20] 
mov DWORD PTR [rax], edx 
mov rax, QWORD PTR [rbp-8] 
mov edx, DWORD PTR [rbp-24] 
mov DWORD PTR [rax+4], edx 
mov rax, QWORD PTR [rbp-8] 
mov edx, DWORD PTR [rbp-28] 
mov DWORD PTR [rax+8], edx 
nop 
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leave 
; RAX hasn't been modified till that point! 
ret 


If | add return rt;, only one instruction is added at the end, which is redundant: 


Listing 3.133: Non-optimizing GCC 5.4 


create color: 


push rbp 

mov rbp, rsp 

sub rsp, 32 

mov DWORD PTR [rbp-20], edi 
mov DWORD PTR [rbp-24], esi 
mov DWORD PTR [rbp-28], edx 
mov edi, 12 


call malloc 
; RAX = pointer to buffer 


mov QWORD PTR [rbp-8], rax 
mov rax, QWORD PTR [rbp-8] 
mov edx, DWORD PTR [rbp-20] 
mov DWORD PTR [rax], edx 
mov rax, QWORD PTR [rbp-8] 
mov edx, DWORD PTR [rbp-24] 
mov DWORD PTR [rax+4], edx 
mov rax, QWORD PTR [rbp-8] 
mov edx, DWORD PTR [rbp-28] 
mov DWORD PTR [rax+8], edx 
; reload pointer to buffer into RAX again, and this is redundant operation... 
mov rax, QWORD PTR [rbp-8] ; new instruction 
leave 
ret 


Bugs like that are very dangerous, sometimes they appear, sometimes hide. It’s like 
Heisenbug. 


Now I’m trying optimizing GCC: 
Listing 3.134: Optimizing GCC 5.4 


create color: 


rep ret 

main: 
xor eax, eax 

; as if create color() was called and returned 0 
sub rsp, 8 
mov r8d, DWORD PTR ds:8 
mov ecx, DWORD PTR [rax+4] 
mov edx, DWORD PTR [rax] 
mov esi, OFFSET FLAT:.LC1 
mov edi, 1 
call . printf chk 
xor eax, eax 
add rsp, 8 
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ret 


Compiler deducing that nothing returns from the function, so it optimizes the whole 
function away. And it assumes, that is returns 0 by default. The zero is then used as 


an address to a structure in main().. Of course, this code crashes. 


GCC in C++ mode silent about it as well. 


Let's try non-optimizing MSVC 2015 x86. It warns about the problem: 


c:\tmp\3.c(19) : warning C4716: 'create color': must return a value 


And generates crashing code: 


Listing 3.135: Non-optimizing MSVC 2015 x86 


_rt$ = -4 

_R$ = 8 

_G$ = 12 

_B$ = 16 

_create_color PROC 
push ebp 
mov ebp, esp 
push ecx 
push 12 
call  malloc 

; EAX = pointer to buffer 
add esp, 4 
mov DWORD PTR rt$[ebp], eax 
mov eax, DWORD PTR rt$[ebp] 
mov ecx, DWORD PTR R$[ebp] 
mov DWORD PTR [eax], ecx 
mov edx, DWORD PTR _rt$[ebp] 
mov eax, DWORD PTR G$[ebp] 

; EAX is set to G argument: 
mov DWORD PTR [edx+4], eax 
mov ecx, DWORD PTR _rt$[ebp] 
mov edx, DWORD PTR B$[ebp] 
mov DWORD PTR [ecx+8], edx 
mov esp, ebp 
pop ebp 

; EAX = G at this point: 
ret 0 


Create color ENDP 


Now optimizing MSVC 2015 x86 generates crashing code as well, but for the different 


reason: 
Listing 3.136: Optimizing MSVC 2015 x86 
_a$ = -4 
_main PROC 
; this is inlined optimized version of create color(): 
push ecx 
push 12 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


818 


call  malloc 

mov DWORD PTR [eax], 1 
mov DWORD PTR [eax+4], 2 
mov DWORD PTR [eax+8], 3 


; EAX points to allocated buffer, and it's filled, OK 
; now we reload pointer to buffer, hoping it's in "a" variable 
; but inlined function didn't store pointer to "a" variable! 
mov eax, DWORD PTR _a$[esp+8] 
; EAX = some random garbage at this point 
push DWORD PTR [eax+8] 
push DWORD PTR [eax+4] 
push DWORD PTR [eax] 
push OFFSET $SG6074 


call _ printf 
xor eax, eax 
add esp, 24 
ret 0 
main  ENDP 
_R$ = 8 
_G$ = 12 
B$= 16 
create color PROC 
push 12 
call  malloc 
mov ecx, DWORD PTR R$[esp] 
add esp, 4 
mov DWORD PTR [eax], ecx 
mov ecx, DWORD PTR G$[esp-4] 
mov DWORD PTR [eax+4], ecx 
mov ecx, DWORD PTR B$[esp-4] 
mov DWORD PTR [eax+8], ecx 
; EAX points to allocated buffer, OK 
ret 0 


Create color ENDP 


However, non-optimizing MSVC 2015 x64 generates working code: 


Listing 3.137: Non-optimizing MSVC 2015 x64 


rt$ - 32 

R$ = 64 

G$ - 72 

B$ - 80 

create color PROC 
mov DWORD PTR [rsp+24], r8d 
mov DWORD PTR [rsp+16], edx 
mov DWORD PTR [rsp+8], ecx 
sub rsp, 56 
mov ecx, 12 
call malloc 

; RAX = allocated buffer 
mov QWORD PTR rt$[rsp], rax 
mov rax, QWORD PTR rt$[rsp] 
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mov ecx, DWORD PTR R$[rsp] 
mov DWORD PTR [rax], ecx 
mov rax, QWORD PTR rt$[rsp] 
mov ecx, DWORD PTR G$[rsp] 
mov DWORD PTR [rax+4], ecx 
mov rax, QWORD PTR rt$[rsp] 
mov ecx, DWORD PTR B$[rsp] 
mov DWORD PTR [rax+8], ecx 
add rsp, 56 

; RAX didn't change down to this point 
ret 0 


create color ENDP 


Optimizing MSVC 2015 x64 also inlines the function, as in case of x86, and the re- 
sulting code also crashes. 


This is a real piece of code from my octothorpe library, that worked and all tests 
passed. It was so, without return for quite a time... 


uint32 t LPHM u32 hash(void *key) 
1 


} 


jenkins one at a time hash u32((uint32 t)key); 


The moral of the story: warnings are very important, use -Wall, etc, etc... When 
return statement is absent, compiler can just silently do nothing at that point. 


Such a bug left unnoticed can ruin a day. 


Also, shotgun debugging is bad, because again, such a bug can left unnoticed ("ev- 
erything works now, so be it, let's leave it as is"). 


See also: discussion at Hacker News® and archived blog post®?. 


3.33 Homework: more about function pointers and 
unions 

This code was copypasted from dwm^, probably, the smallest ever Linux window 

manager. 


The problem: keystrokes from user must be dispatched to various functions inside 
of dwm. This is usually solved using a big switch(). 


Usually, this is an important problem to be solved by a programmer of any videogame. 
Supposedly, dwm's creators wanted to make the code neat and modifiable by users: 


62https://news.ycombinator.com/item?id=18671609 
63https://web.archive.org/web/20190317231721/https://yurichev.com/blog/no return/ 
64https://dwm.suckless.org/ 
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typedef union { 
int i; 
unsigned int ui; 
float f; 
const void *v; 

} Arg; 


typedef struct { 
unsigned int mod; 
KeySym keysym; 
void (*func)(const Arg *); 
const Arg arg; 
} Key; 


static Key keys[] = { 


/* modifier key function argument */ 
{ MODKEY, XK_p, Spawn, {.v = dmenucmd } }, 
{ MODKEY|ShiftMask, XK_Return, spawn, {.v = termcmd } }, 
{ MODKEY, XK_b, togglebar, (10) }, 
( MODKEY, XK j, focusstack, {.i = +1 } }, 
{ MODKEY, XK_k, focusstack, {.i = -1 } }, 
{ MODKEY, XK_i, incnmaster, {.i = +1 } }, 
{ MODKEY, XK_d, incnmaster, {.i = -1 } }, 
{ MODKEY, XK_h, setmfact, {.f = -0.05) }, 
{ MODKEY, XK 1, setmfact, {.f = 40.05) }, 
{ MODKEY, XK_Return, zoom, (0) $, 
{ MODKEY, XK_Tab, view, (0) }, 
{ MODKEY|ShiftMask, XK c, killclient, (0) }, 
{ MODKEY, XK_t, setlayout, {.v = &layouts[0]} }, 
{ MODKEY, XK_f, setlayout, {.v = &layouts[1]} }, 
{ MODKEY, XK_m, setlayout, {.v = &layouts[2]} }, 
void 
spawn(const Arg *arg) 
1 
void 
focusstack(const Arg *arg) 
1 


For each keystroke (or shortcut) a function is defined. Even more: a parameters 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


821 
(or arguments) to be passed to a function at each case. But parameters can have 
various type. So union is used here. A value of needed type is filled in the table. 
Each function takes what it needs. 


As a homework, try to write a code like that, or get into dwm's and see how union is 
passed into functions and handled. 


3.34 Windows 16-bit 


16-bit Windows programs are rare nowadays, but can be used in the cases of retro- 
computing or dongle hacking (8.8 on page 1055). 


16-bit Windows versions were up to 3.11. 95/98/ME also support 16-bit code, as well 
as the 32-bit versions of the Windows NT line. The 64-bit versions of Windows NT 
line do not support 16-bit executable code at all. 


The code resembles MS-DOS's one. 
Executable files are of type NE-type (so-called "new executable"). 


All examples considered here were compiled by the OpenWatcom 1.9 compiler, using 
these switches: 


wcl.exe -i=C:/WATCOM/h/win/ -s -os -bt=windows -bcl=windows example.c 


3.34.1 Example+1 


#include «windows.h» 


int PASCAL WinMain( HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
LPSTR lpCmdLine, 
int nCmdShow ) 


1 
MessageBeep(MB ICONEXCLAMATION); 
return 0; 
$; 
WinMain proc near 
push bp 
mov bp, sp 
mov ax, 30h ; '0' ; MB ICONEXCLAMATION constant 
push ax 
call MESSAGEBEEP 
xor ax, ax ; return 0 
pop bp 
retn 0Ah 
WinMain endp 


Seems to be easy, so far. 
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3.34.2 Example #2 


#include «windows.h» 


int PASCAL WinMain( HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
LPSTR lpCmdLine, 
int nCmdShow ) 


1 
MessageBox (NULL, "hello, world", "caption", MB YESNOCANCEL); 
return 0; 
}; 
WinMain proc near 
push bp 
mov bp, sp 
xor ax, ax ; NULL 
push ax 
push ds 
mov ax, offset aHelloWorld ; 0x18. "hello, world" 
push ax 
push ds 
mov ax, offset aCaption ; 0x10. "caption" 
push ax 
mov ax, 3 ; MB YESNOCANCEL 
push ax 
call MESSAGEBOX 
xor ax, ax ; return 0 
pop bp 
retn OAh 
WinMain endp 
dseg02:0010 aCaption db 'caption',0 
dseg02:0018 aHelloWorld db 'hello, world',0 


Couple important things here: the PASCAL calling convention dictates passing the 
first argument first (MB YESNOCANCEL), and the last argument—last (NULL). This con- 
vention also tells the callee to restore the stack pointer: hence the RETN instruction 
has 0Ah as argument, which implies that the pointer has to be increased by 10 bytes 
when the function exits. It is like stdcall (6.1.2 on page 932), but the arguments are 
passed in "natural" order. 


The pointers are passed in pairs: first the data segment is passed, then the pointer 
inside the segment. There is only one segment in this example, so DS always points 
to the data segment of the executable. 


3.34.3 Example #3 


#include «windows.h» 


int PASCAL WinMain( HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
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LPSTR lpCmdLine, 
int nCmdShow ) 


1 
int result=MessageBox (NULL, "hello, world", "caption", MB YESNOCANCEL) 7 
S 
if (result--IDCANCEL) 
MessageBox (NULL, "you pressed cancel", "caption", MB OK); 
else if (result--IDYES) 
MessageBox (NULL, "you pressed yes", "caption", MB OK); 
else if (result--IDNO) 
MessageBox (NULL, "you pressed no", "caption", MB OK); 
return 0; 
}; 
WinMain proc near 
push bp 
mov bp, sp 
xor ax, ax ; NULL 
push ax 
push ds 
mov ax, offset aHelloWorld ; "hello, world" 
push ax 
push ds 
mov ax, offset aCaption ; "caption" 
push ax 
mov ax, 3 ; MB YESNOCANCEL 
push ax 
call MESSAGEBOX 
cmp ax, 2 ; IDCANCEL 
jnz short loc 2F 
xor ax, ax 
push ax 
push ds 
mov ax, offset aYouPressedCanc ; "you pressed cancel" 
jmp short loc 49 
loc 2F: 
cmp ax, 6 ; IDYES 
jnz short loc 3D 
xor ax, ax 
push ax 
push ds 
mov ax, offset aYouPressedYes ; "you pressed yes" 
jmp short loc 49 
loc 3D: 
cmp ax, 7 ; IDNO 
jnz short loc 57 
xor ax, ax 
push ax 
push ds 
mov ax, offset aYouPressedNo ; "you pressed no" 
loc 49: 
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push ax 

push ds 

mov ax, offset aCaption ; "caption" 

push ax 

xor ax, ax 

push ax 

call MESSAGEBOX 
loc 57: 

xor ax, ax 

pop bp 

retn 0Ah 
WinMain endp 


Somewhat extended example from the previous section . 


3.34.4 Example #4 


#include «windows.h» 


int PASCAL funcl (int a, int b, int c) 


{ 
return a*b+c; 
}; 
long PASCAL func2 (long a, long b, long c) 
{ 
return a*b+c; 
}; 
long PASCAL func3 (long a, long b, long c, int d) 
{ 
return a*b+c-d; 
}; 


int PASCAL WinMain( HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
LPSTR lpCmdLine, 
int nCmdShow ) 


{ 
funcl (123, 456, 789); 
func2 (600000, 700000, 800000); 
func3 (600000, 700000, 800000, 123); 
return 0; 
}; 
funcl proc near 
c = word ptr 4 
b = word ptr 6 
a = word ptr 8 
push bp 
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funcl 
func2 


arg 0 
arg 2 
arg 4 
arg 6 
arg 8 
arg A 


mov bp, sp 
mov ax, [bp+a] 
imul [bp+b ] 
add ax, [bp+c] 
pop bp 
retn 6 
endp 
proc near 
word ptr 4 
word ptr 6 
word ptr 8 


word ptr OAh 
word ptr OCh 
word ptr OEh 


call sub B2 ; long 32-bit multiplication 


push bp 
mov bp, sp 
mov ax, [bp-«arg 8] 
mov dx, [bptarg A] 
mov bx, [bpt+arg 4] 
mov cx, [bp+arg 6] 
add ax, [bptarg 0] 
adc dx, [bptarg 2] 
pop bp 
retn 12 
endp 
proc near 

word ptr 4 

word ptr 6 

word ptr 8 


word ptr OAh 
word ptr (Ch 
word ptr OEh 
word ptr 10h 


call sub B2 ; long 32-bit multiplication 


push bp 

mov bp, sp 

mov ax, [bptarg A] 
mov dx, [bptarg C] 
mov bx, [bp+arg 6] 
mov cx, [bp+arg 8] 
mov cx, [bptarg 2] 
add CX, ax 

mov bx, [bpt+arg 4] 
adc bx, dx 

mov ax, [bp-«arg 0] 
cwd 


; BX=high part, CX=low part 


; AX=low part d, DX=high part d 
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sub 
mov 
sbb 
mov 
pop 
retn 
func3 endp 


WinMain proc 
push 
mov 
mov 
push 
mov 
push 
mov 
push 
call 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
call 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
mov 
push 
call 
xor 
pop 
retn 

WinMain endp 


ax 
CX 
dx 
bx 


27COh ; 


OAE60h ; 


OCh 


3500h ; 


27COh ; 


OAE60h ; 


OCh 


3500h ; 


high part of 600000 
low part of 600000 
high part of 700000 
low part of 700000 
high part of 800000 


low part of 800000 


high part of 600000 
low part of 600000 
high part of 700000 
low part of 700000 
high part of 800000 
low part of 800000 


123 


return 0 


32-bit values (the Long data type implies 32 bits, while int is 16-bit) in 16-bit code 


(both MS-DOS and Win16) are passed in pairs. 


It is just like when 64-bit values are 
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used in a 32-bit environment (1.34 on page 497). 


sub B2 here is a library function written by the compiler's developers that does 
"long multiplication", i.e., multiplies two 32-bit values. Other compiler functions 
that do the same are listed here: .5 on page 1320, .4 on page 1320. 


The ADD/ADC instruction pair is used for addition of compound values: ADD may 
set/clear the CF flag, and ADC uses it after. 


The SUB/SBB instruction pair is used for subtraction: SUB may set/clear the CF flag, 
SBB uses it after. 


32-bit values are returned from functions in the DX:AX register pair. 
Constants are also passed in pairs in WinMain() here. 


The int-typed 123 constant is first converted according to its sign into a 32-bit value 
using the CWD instruction. 


3.34.5 Example £5 


#include «windows.h» 


int PASCAL string compare (char *s1, char *s2) 


1 
while (1) 
1 
if (*s1!=*s2) 
return 0; 
if (*sl==0 || *s2==0) 
return 1; // end of string 
s1++; 
S2++; 
Hh 
$; 
int PASCAL string compare far (char far *s1, char far *s2) 
1 
while (1) 
1 
if (*s1!=*s2) 
return 0; 
if (*sl==0 || *s2==0) 
return 1; // end of string 
s1++; 
S2++; 
}; 
}; 
void PASCAL remove digits (char *s) 
{ 
while (*s) 
{ 
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if (*s>='0' && *s<='9') 
*g='-'; 
S++; 
}; 
ur 


char str[]="hello 1234 world"; 


int PASCAL WinMain( HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
LPSTR lpCmdLine, 
int nCmdShow ) 


1 
string compare ("asd", "def"); 
string compare far ("asd", "def"); 
remove digits (str); 
MessageBox (NULL, str, "caption", MB YESNOCANCEL) ; 
return 0; 
}; 


string_compare proc near 


arg 0 = word ptr 4 
arg_2 = word ptr 6 
push bp 
mov bp, sp 
push si 
mov si, [bp+arg_0] 
mov bx, [bp+arg_2] 
loc 12: ; CODE XREF: string compare+21j 
mov al, [bx] 
cmp al, [si] 
jz short loc 1C 
xor ax, ax 
jmp short loc 2B 


loc 1C: ; CODE XREF: string compare+Ej 
test al, al 


jz short loc 22 
jnz short loc 27 
loc 22: ; CODE XREF: string compare-16j 
mov ax, 1 
jmp short loc 2B 


loc 27: ; CODE XREF: string compare-18j 


inc bx 
inc si 
jmp short loc 12 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


829 


loc 2B: ; CODE XREF: string compare-12j 
; String compare-1Dj 


pop si 
pop bp 
retn 4 


string compare endp 


string compare far proc near ; CODE XREF: WinMain+18p 


arg 0 = word ptr 4 
arg 2 - word ptr 6 
arg 4 - word ptr 8 
arg 6 = word ptr  0Ah 
push bp 
mov bp, sp 
push si 
mov si, [bp+arg 0] 
mov bx, [bp+arg 4] 
loc 3A: ; CODE XREF: string compare far-35j 
mov es, [bptarg 6] 
mov al, es: [bx] 
mov es, [bptarg 2] 
cmp al, es:[si] 
jz short loc 4C 
xor ax, ax 
jmp short loc 67 


loc 4C: ; CODE XREF: string compare far-16j 


mov es, [bptarg 6] 
cmp byte ptr es:[bx], 0 
jz short loc 5E 
mov es, [bptarg 2] 
cmp byte ptr es:[si], 0 
jnz short loc 63 
loc 5E: ; CODE XREF: string compare far-23j 
mov ax, 1 
jmp short loc 67 


loc 63: ; CODE XREF: string compare far-2Cj 


inc bx 
inc si 
jmp short loc 3A 


loc 67: ; CODE XREF: string compare far-1Aj 
; String compare far-31j 
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pop si 
pop bp 
retn 8 


string compare far endp 
remove digits proc near ; CODE XREF: WinMain+1Fp 


arg 0 = word ptr 4 


push bp 
mov bp, sp 
mov bx, [bp«arg 0] 
loc 72: ; CODE XREF: remove digits+18j 
mov al, [bx] 
test al, al 
jz short loc 86 
cmp al, 30h ; '0' 
jb short loc 83 
cmp al, 39h ; '9' 
ja short loc 83 
mov byte ptr [bx], 2Dh ; '-' 


loc 83: ; CODE XREF: remove digits+Ej 
; remove digits+12j 
inc bx 
jmp short loc 72 


loc 86: ; CODE XREF: remove digits+Aj 
pop bp 
retn 2 

remove digits endp 


WinMain proc near ; CODE XREF: start+EDp 


push bp 

mov bp, sp 

mov ax, offset aAsd ; "asd" 
push ax 

mov ax, offset aDef ; "def" 
push ax 

call string compare 

push ds 

mov ax, offset aAsd ; "asd" 
push ax 

push ds 

mov ax, offset aDef ; "def" 
push ax 

call string compare far 

mov ax, offset aHellol234World ; "hello 1234 world" 
push ax 

call remove digits 

xor ax, ax 
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push ax 

push ds 

mov ax, offset aHellol234World ; "hello 1234 world" 
push ax 

push ds 

mov ax, offset aCaption ; "caption" 
push ax 

mov ax, 3 ; MB YESNOCANCEL 

push ax 

call MESSAGEBOX 

xor ax, ax 

pop bp 

retn OAh 


WinMain endp 


Here we see a difference between the so-called “near” pointers and the “far” point- 
ers: another weird artifact of segmented memory in 16-bit 8086. 


You can read more about it here: 11.7 on page 1264. 


“near” pointers are those which point within the current data segment. Hence, the 
string compare() function takes only two 16-bit pointers, and accesses the data 
from the segment that DS points to (The mov al, [bx] instruction actually works 
like mov al, ds: [bx] — DS is implicit here). 


“far” pointers are those which may point to data in another memory segment. 
Hence string compare far() takes the 16-bit pair as a pointer, loads the high part 
of it in the ES segment register and accesses the data through it 

(mov al, es:[bx]). “far” pointers are also used in my 

MessageBox() win16 example: 3.34.2 on page 822. Indeed, the Windows kernel is 
not aware which data segment to use when accessing text strings, so it need the 
complete information. 


The reason for this distinction is that a compact program may use just one 64kb data 
segment, so it doesn't need to pass the high part of the address, which is always 
the same. A bigger program may use several 64kb data segments, so it needs to 
specify the segment of the data each time. 


It's the same story for code segments. A compact program may have all executable 
code within one 64kb-segment, then all functions in it will be called using the CALL 
NEAR instruction, and the code flow will be returned using RETN. But if there are 
several code segments, then the address of the function is to be specified by a pair, 
it is to be called using the CALL FAR instruction, and the code flow is to be returned 
using RETF. 


This is what is set in the compiler by specifying "memory model". 


The compilers targeting MS-DOS and Win16 have specific libraries for each memory 
model: they differ by pointer types for code and data. 


3.34.6 Example #6 


| include <windows .h> 
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#include <time.h> 
#include <stdio.h> 


char strbuf[256]; 


int PASCAL WinMain( 


HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
LPSTR lpCmdLine, 

int nCmdShow ) 


1 
struct tm *t; 
time t unix time; 
unix time-time (NULL); 
t=localtime (&unix time); 
sprintf (strbuf, "%04d-%02d-%02d %02d:%02d:%02d", t->tm_year+1900, 7 
y t->tm_mon, t->tm_mday, 
t->tm_hour, t->tm_min, t->tm_sec); 
MessageBox (NULL, strbuf, "caption", MB OK); 
return 0; 
}; 
WinMain proc near 
var 4 - word ptr -4 
var 2 - word ptr -2 
push bp 
mov bp, sp 
push ax 
push ax 
xor ax, ax 
call time 
mov [bp+var_4], ax ; low part of UNIX time 
mov [bp+var_2], dx ; high part of UNIX time 
lea ax, [bp-*var 4] ; take a pointer of high part 
call localtime 
mov bx, ax |t 
push word ptr [bx] ; Second 
push word ptr [bx+2] ; minute 
push word ptr [bx+4]  ; hour 
push word ptr [bx+6] ; day 
push word ptr [bx+8] ; month 
mov ax, [bx+0Ah] ; year 
add ax, 1900 
push ax 
mov ax, offset aQ4d02d02d02d02 ; 


"%04d-%02d-%02d %02d:%02d:%02d" 
push 


mov 


ax 
ax, offset strbuf 
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push ax 
call sprintf 
add sp, 10h 
xor ax, ax ; NULL 
push ax 
push ds 
mov ax, offset strbuf 
push ax 
push ds 
mov ax, offset aCaption ; "caption" 
push ax 
xor ax, ax ; MB OK 
push ax 
call MESSAGEBOX 
xor ax, ax 
mov sp, bp 
pop bp 
retn 0Ah 
WinMain endp 


UNIX time is a 32-bit value, so it is returned in the DX:AX register pair and stored in 
two local 16-bit variables. Then a pointer to the pair is passed to the localtime() 
function. The localtime() function has a struct tm allocated somewhere in the 
guts of the C library, so only a pointer to it is returned. 


By the way, this also implies that the function cannot be called again until its results 
are used. 


For the time() and localtime() functions, a Watcom calling convention is used 
here: the first four arguments are passed in the AX, DX, BX and CX, registers, and the 
rest arguments are via the stack. 


The functions using this convention are also marked by underscore at the end of 
their name. 


sprintf() does not use the PASCAL calling convention, nor the Watcom one, 
so the arguments are passed in the normal cdecl way (6.1.1 on page 932). 


Global variables 


This is the same example, but now these variables are global: 


#include «windows.h» 
#include <time.h> 
#include <stdio.h> 


char strbuf[256]; 
struct tm *t; 
time t unix time; 


int PASCAL WinMain( HINSTANCE hInstance, 
HINSTANCE hPrevInstance, 
LPSTR lpCmdLine, 
int nCmdShow ) 
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unix time-time (NULL); 


t=localtime (&unix time); 


sprintf (strbuf, "%04d-%02d-%02d %02d:%02d:%02d", t->tm_year+1900, 7 


4 t->tm_mon, t->tm_mday, 
t->tm_hour, t->tm_min, t->tm_sec); 


MessageBox (NULL, strbuf, "caption", MB OK); 
return 0; 


unix time low dw 


0 
unix time high dw 0 
0 


t dw 
WinMain proc near 
push bp 
mov bp, sp 
xor ax, ax 
call time 
mov unix time low, ax 
mov unix time high, dx 
mov ax, offset unix time low 
call localtime 
mov bx, ax 
mov t, ax ; will not be used in future... 
push word ptr [bx] ; Seconds 
push word ptr [bx+2] ; minutes 
push word ptr [bx+4] ; hour 
push word ptr [bx+6] ; day 
push word ptr [bx+8] ; month 
mov ax, [bx+0Ah] ; year 
add ax, 1900 
push ax 
mov ax, offset a04d02d02d02d02 ; 
"%04d-%02d-%02d %02d:%02d:%02d" 
push ax 
mov ax, offset strbuf 
push ax 
call sprintf 
add sp, 10h 
xor ax, ax ; NULL 
push ax 
push ds 
mov ax, offset strbuf 
push ax 
push ds 
mov ax, offset aCaption ; "caption" 
push ax 
xor ax, ax ; MB OK 
push ax 
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call MESSAGEBOX 


xor ax, ax ; return 0 
pop bp 
retn 0Ah 
WinMain endp 


t is not to be used, but the compiler emitted the code which stores the value. 


Because it is not sure, maybe that value will eventually be used in some other mod- 
ule. 
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Java 


4.1 Java 


4.1.1 Introduction 


There are some well-known decompilers for Java (or JVM bytecode in general) ?. 


The reason is the decompilation of JVM-bytecode is somewhat easier than for lower 
level x86 code: 


* There is much more information about the data types. 
* The JVM memory model is much more rigorous and outlined. 


* The Java compiler don't do any optimizations (the JVM JIT? does them at run- 
time), so the bytecode in the class files is usually pretty readable. 


When can the knowledge of JVM be useful? 


Quick-and-dirty patching tasks of class files without the need to recompile the 
decompiler's results. 


Analyzing obfuscated code. 


Analyzing of a code generated by newer Java compiler for which no updated 
decompiler exists yet. 


Building your own obfuscator. 


Building a compiler codegenerator (back-end) targeting JVM (like Scala, Clojure, 
etc. ?). 


Let's start with some simple pieces of code. JDK 1.7 is used everywhere, unless 
mentioned otherwise. 


lFor example, JAD: http: //varaneckas.com/jad/ 
2Just-In-Time compilation 
3Full list: http://en.wikipedia.org/wiki/List of JVM languages 
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This is the command used to decompile class files everywhere: 
javap -c -verbose. 


This is the book | used while preparing all examples: [Tim Lindholm, Frank Yellin, 
Gilad Bracha, Alex Buckley, The Java(R) Virtual Machine Specification / Java SE 7 
Edition] ^. 


4.1.2 Returning a value 


Probably the simplest Java function is the one which returns some value. 


Oh, and we must keep in mind that there are no "free" functions in Java in common 
sense, they are "methods". 


Each method is related to some class, so it's not possible to define a method outside 
of a class. 


But we'll call them "functions" anyway, for simplicity. 


public class ret 


1 
public static int main(String[] args) 
1 
return 0; 
} 
} 


Let's compile it: 


javac ret.java 


...and decompile it using the standard Java utility: 


javap -c -verbose ret.class 


And we get: 
Listing 4.1: JDK 1.7 (excerpt) 


public static int main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-1, locals-1, args size-1 
0: iconst 0 
1: ireturn 


The Java developers decided that 0 is one of the busiest constants in programming, 
so there is a separate short one-byte iconst 0 instruction which pushes 0 


5. There are also iconst 1 (which pushes 1), iconst 2, etc., up to iconst 5. 


^Also available as https://docs.oracle.com/javase/specs/jvms/se7/jvms7.pdf; http://docs. 
oracle.com/javase/specs/jvms/se7/html/ 
5Just like in MIPS, where a separate register for zero constant exists: 1.5.4 on page 35. 
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There is also iconst ml which pushes -1. 


The stack is used in JVM for passing data to called functions and also for return values. 
So iconst 0 pushes 0 into the stack. ireturn returns an integer value (i in name 
means integer) from the TOS. 


Let's rewrite our example slightly, now we return 1234: 


public class ret 


{ 
public static int main(String[] args) 
{ 
return 1234; 
} 
} 
...We get: 


Listing 4.2: JDK 1.7 (excerpt) 


public static int main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals-1, args size-1 
0: sipush 1234 
3: ireturn 


sipush (short integer) pushes 1234 into the stack. short in name implies a 16-bit 
value is to be pushed. The number 1234 indeed fits well in a 16-bit value. 


What about larger values? 


public class ret 


{ 

public static int main(String[] args) 

{ 

return 12345678; 

} 

} 
Listing 4.3: Constant pool 
#2 = Integer 12345678 


public static int main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals-1, args size-1 
0: ldc #2 // int 12345678 
2: ireturn 


STop of Stack 
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It’s not possible to encode a 32-bit number in a JVM instruction opcode, the develop- 
ers didn't leave such possibility. 


So the 32-bit number 12345678 is stored in so called "constant pool" which is, let's 
say, the library of most used constants (including strings, objects, etc.). 


This way of passing constants is not unique to JVM. 


MIPS, ARM and other RISC CPUs also can't encode a 32-bit number in a 32-bit opcode, 
so the RISC CPU code (including MIPS and ARM) has to construct the value in several 
steps, or to keep it in the data segment: 1.39.3 on page 556, 1.40.1 on page 561. 


MIPS code also traditionally has a constant pool, named "literal pool", the segments 
are called “.lit4” (for 32-bit single precision floating point number constants) and 
" |it8" (for 64-bit double precision floating point number constants). 


Let's try some other data types! 


Boolean: 
public class ret 
1 
public static boolean main(String[] args) 
1 
return true; 
} 
} 


public static boolean main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-1, locals-1, args size-1 
0: iconst 1 
1: ireturn 


This JVM bytecode is no different from one returning integer 1. 
32-bit data slots in the stack are also used here for boolean values, like in C/C++. 


But one could not use returned boolean value as integer or vice versa — type infor- 
mation is stored in the class file and checked at runtime. 


It's the same story with a 16-bit short: 


public class ret 


1 
public static short main(String[] args) 
1 
return 1234; 
} 
} 


public static short main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-1, locals-1, args size-1 
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0: sipush 1234 
3: ireturn 
...and char! 
public class ret 
1 
public static char main(String[] args) 
{ 
return 'A'; 
} 
} 


public static char main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals-1, args size-1 
0: bipush 65 
2: ireturn 


bipush means "push byte". Needless to say that a char in Java is 16-bit UTF-16 
character, and it's equivalent to short, but the ASCII code of the "A" character is 65, 
and it's possible to use the instruction for pushing a byte in the stack. 


Let's also try a byte: 


public class retc 


{ 
public static byte main(String[] args) 
{ 
return 123; 
} 
} 


public static byte main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals-1, args size-1 
0: bipush 123 
2: ireturn 


One may ask, why bother with a 16-bit short data type which internally works as a 
32-bit integer? 


Why use a char data type if it is the same as a short data type? 
The answer is simple: for data type control and source code readability. 


A char may essentially be the same as a short, but we quickly grasp that it's a 
placeholder for an UTF-16 character, and not for some other integer value. 


When using short, we show everyone that the variable's range is limited by 16 bits. 
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It’s a very good idea to use the boolean type where needed to, instead of the C-style 
int. 


There is also a 64-bit integer data type in Java: 


public class ret3 


1 
public static long main(String[] args) 
{ 
return 1234567890123456789L; 
} 
} 
Listing 4.4: Constant pool 
#2 = Long 12345678901234567891 


public static long main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-1, args size-1 
0: ldc2 w #2 // long 12345678901234567891 
3: lreturn 


The 64-bit number is also stored in a constant pool, ldc2_w loads it and lreturn 
(long return) returns it. 


The ldc2_w instruction is also used to load double precision floating point numbers 
(which also occupy 64 bits) from a constant pool: 


public class ret 


{ 
public static double main(String[] args) 
{ 
return 123.456d; 
} 
} 
Listing 4.5: Constant pool 


42 = Double 123.456d 


public static double main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-1, args size-1 
0: ldc2 w #2 // double 123.456d 
3: dreturn 
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dreturn stands for "return double". 


And finally, a single precision floating point number: 


public class ret 
1 

public static float main(String[] args) 

1 

return 123.456f; 

} 

} 
Listing 4.6: Constant pool 


#2 = Float 123.456f 


public static float main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals-1, args size-1 
0: ldc #2 // float 123.456f 
2: freturn 


The ldc instruction used here is the same one as for loading 32-bit integer numbers 
from a constant pool. 


freturn stands for “return float”. 


Now what about function that return nothing? 


public class ret 


{ 
public static void main(String[] args) 
{ 
return; 
} 
} 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack=0, locals-1, args size-1 
0: return 


This means that the return instruction is used to return control without returning an 
actual value. 


Knowing all this, it’s very easy to deduce the function's (or method's) returning type 
from the last instruction. 
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4.1.3 Simple calculating functions 


Let's continue with a simple calculating functions. 


public class calc 


1 
public static int half(int a) 
1 
return a/2; 
} 
} 


Here's the output when the iconst 2 instruction is used: 


public static int half(int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-2, locals-1, args size-1 

0: iload 0 
1: iconst 2 
2: idiv 
3: ireturn 


iload 0 takes the zeroth function argument and pushes it to the stack. 


iconst 2 pushes 2 in the stack. After the execution of these two instructions, this 
is how stack looks like: 


+---+ 
TOS ->| 2 | 
+---+ 
| a | 
+---+ 


idiv just takes the two values at the TOS, divides one by the other and leaves the 
result at TOS: 


TOS ->| result | 


ireturn takes it and returns. 


Let’s proceed with double precision floating point numbers: 


public class calc 


{ 
public static double half double(double a) 
{ 
return a/2.0; 
} 
} 
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Listing 4.7: Constant pool 


#2 = Double 2.0d 


public static double half_double(double) ; 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-4, locals-2, args size-1 
0: dload 0 
1: ldc2 w #2 // double 2.0d 
4: ddiv 
5: dreturn 


It’s the same, but the ldc2_w instruction is used to load the constant 2.0 from the 
constant pool. 


Also, the other three instructions have the d prefix, meaning they work with double 
data type values. 


Let’s now use a function with two arguments: 


public class calc 


{ 
public static int sum(int a, int b) 
{ 
return atb; 
} 
} 


public static int sum(int, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-2, locals-2, args size-2 
0: iload 0 
1: iload 1 
2: iadd 
3: ireturn 


iload 0 loads the first function argument (a), iload 1—second (b). 


Here is the stack after the execution of both instructions: 


+---+ 
TOS ->| b | 
+---+ 
| a | 
+---+ 


iadd adds the two values and leaves the result at TOS: 


TOS ->| result | 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


845 


Let's extend this example to the /ong data type: 


public static long lsum(long a, long b) 
1 


) 


return atb; 


...We got: 


public static long lsum(long, long); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-4, locals-4, args size-2 

0: lload 0 
1: lload 2 
2: ladd 
3: lreturn 


The second lload instruction takes the second argument from the 2nd slot. 
That's because a 64-bit Jong value occupies exactly two 32-bit slots. 
Slightly more advanced example: 


public class calc 


1 
public static int mult add(int a, int b, int c) 
{ 
return a*b+c; 
} 
} 


public static int mult_add(int, int, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-2, locals-3, args size-3 
: iload 0 
iload 1 
imul 
iload 2 
iadd 
ireturn 
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The first step is multiplication. The product is left at the TOS: 
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| product | 


Now the iadd instruction can add the two values. 


4.1.4 JVM memory model 


x86 and other low-level environments use the stack for argument passing and as a 
local variables storage. 


JVM is slightly different. 
It has: 


* Local variable array (LVA’). Used as storage for incoming function arguments 
and local variables. 


Instructions like iload 0 load values from it. 


istore stores values in it. At the beginning the function arguments are stored: 
starting at 0 or at 1 (if the zeroth argument is occupied by this pointer). 


Then the local variables are allocated. 
Each slot has size of 32-bit. 


Hence, values of long and double data types occupy two slots. 


Operand stack (or just "stack"). It's used for computations and passing argu- 
ments while calling other functions. 


Unlike low-level environments like x86, it's not possible to access the stack 
without using instructions which explicitly pushes or pops values to/from it. 


* Heap. It is used as storage for objects and arrays. 
These 3 areas are isolated from each other. 


4.1.5 Simple function calling 


Math.random() returns a pseudorandom number in range of [0.0 ...1.0], but let's say 
that for some reason we need to devise a function that returns a number in range 
of [0.0 ...0.5]: 


public class HalfRandom 


1 
public static double f() 
1 
return Math.random()/2; 
} 
} 


7(Java) Local Variable Array 
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Listing 4.8: Constant pool 


#2 


= Methodref #18.#19 //  java/lang/Math. random: ()D 
#3 = Double 2.0d 
#12 = Utf8 ()D 
#18 = Class #22 // java/lang/Math 
#19 = NameAndType #23:#12 // random: ()D 
#22 = Utf8 java/lang/Math 
#23 = Utf8 random 


public static double f(); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-4, locals=0, args size=0 
0: invokestatic #2 // Method java/lang/Math. random: ()D 
3: ldc2 w #3 // double 2.0d 
6: ddiv 
7: dreturn 


invokestatic calls the Math. random() function and leaves the result at the TOS. 
Then the result is divided by 2.0 and returned. 

But how is the function name encoded? 

It’s encoded in the constant pool using a Methodref expression. 

It defines the class and method names. 


The first field of Methodref points to a Class expression which, in turn, points to the 
usual text string (“java/lang/Math”). 


The second Methodref expression points to a NameAndType expression which also 
has two links to the strings. 


The first string is “random”, which is the name of the method. 


The second string is "()D", which encodes the function's type. It means that it returns 
a double value (hence the D in the string). 


This is the way 1) JVM can check data for type correctness; 2) Java decompilers can 
restore data types from a compiled class file. 


Now let’s try the “Hello, world!” example: 


public class HelloWorld 


{ 
public static void main(String[] args) 
{ 
System.out.println("Hello, World"); 
} 
} 
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Listing 4.9: Constant pool 


#2 = Fieldref #16.#17 // java/lang/System.out:Ljava/iov 
y /PrintStream; 
#3 = String #18 // Hello, World 
#4 = Methodref #19.#20 // java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 
#16 = Class #23 // java/lang/System 
#17 = NameAndType #24:#25 // out:Ljava/io/PrintStream; 
#18 = Utf8 Hello, World 
#19 = Class #26 // java/io/PrintStream 
#20 = NameAndType #27:#28 // println:(Ljava/lang/String;)V 
#23 = Utf8 java/lang/System 
#24 = Utf8 out 
#25 = Utf8 Ljava/io/PrintStream; 
#26 = Utf8 java/io/PrintStream 
#27 = Utf8 println 
= Utf8 (Ljava/lang/String;)V 


#28 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-1, args size-1 

0: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

3: ldc 33 // String Hello, World 

5: invokevirtual £4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

8: return 


ldc at offset 3 takes a pointer to the "Hello, World” string in the constant pool and 
pushes in the stack. 


It's called a reference in the Java world, but it's rather a pointer, or an address 

8 

The familiar invokevirtual instruction takes the information about the println 
function (or method) from the constant pool and calls it. 

As we may know, there are several println methods, one for each data type. 

Our case is the version of println intended for the String data type. 

But what about the first getstatic instruction? 


This instruction takes a reference (or address of) a field of the object System.out 
and pushes it in the stack. 


This value is acts like the this pointer for the println method. 


8About difference in pointers and reference's in C++ see: 3.21.3 on page 705. 
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Thus, internally, the println method takes two arguments for input: 1) this, i.e., a 
pointer to an object; 2) the address of the "Hello, World" string. 


Indeed, println() is called as a method within an initialized System.out object. 


For convenience, the javap utility writes all this information in the comments. 


4.1.6 Calling beep() 


This is a simple calling of two functions without arguments: 


public static void main(String[] args) 


1 
un 


java.awt.Toolkit.getDefaultToolkit().beep(); 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack=1, locals-1, args size-1 

0: invokestatic 72 // Method java/awt/Toolkit.^ 

y getDefaultToolkit: ()Ljava/awt/Toolkit; 
3: invokevirtual #3 // Method java/awt/Toolkit.beep:()V 
6: return 


First invokestatic at offset O calls 

java.awt.Toolkit.getDefaultToolkit(), which returns a reference to an object 
of class Toolkit. 

The invokevirtual instruction at offset 3 calls the beep() method of this class. 


4.1.7 Linear congruential PRNG 


Let's try a simple pseudorandom numbers generator, which we already considered 
once in the book (1.29 on page 424): 


public class LCG 
: public static int rand state; 
public void my srand (int init) 
rand state-init; 
public static int RNG_a=1664525; 
public static int RNG c-1013904223; 
public int my rand () 
rand state-rand state*RNG a; 


rand state-rand state+RNG c; 
return rand state & Ox7fff; 
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There are couple of class fields which are initialized at start. 


But how? In javap output we can find the class constructor: 


static {}; 
flags: ACC STATIC 
Code: 
stack=1, locals=0, args size-0 

0: ldc #5 // int 1664525 
2: putstatic #3 // Field RNG a:I 
5: ldc #6 // int 1013904223 
7: putstatic #4 // Field RNG c:I 
10: return 


That’s the way variables are initialized. 


RNG a occupies the 3rd slot in the class and RNG c—4th, and putstatic puts the 
constants there. 


The my srand() function just stores the input value in rand state: 


public void my srand(int); 
flags: ACC PUBLIC 


Code: 
stack-1, locals-2, args size-2 
0: iload 1 
1: putstatic #2 // Field rand state:I 
4: return 


iload 1 takes the input value and pushes it into stack. But why not iload 0? 


It's because this function may use fields of the class, and so this is also passed to 
the function as a zeroth argument. 


The field rand state occupies the 2nd slot in the class, so putstatic copies the 
value from the TOS into the 2nd slot. 


Now my rand(): 


public int my rand(); 
flags: ACC PUBLIC 


Code: 
stack-2, locals-1, args size-1 

0: getstatic #2 // Field rand state:I 
3: getstatic #3 // Field RNG a:I 

6: imul 

7: putstatic #2 // Field rand state:I 
10: getstatic #2 // Field rand state:I 
13: getstatic #4 // Field RNG c:I 

16: iadd 

17: putstatic #2 // Field rand state:I 
20: getstatic #2 // Field rand state:I 
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23: sipush 32767 
26: iand 
27: ireturn 


It just loads all the values from the object's fields, does the operations and updates 
rand state's value using the putstatic instruction. 


At offset 20, rand state is reloaded again (because it has been dropped from the 
stack before, by putstatic). 


This looks like non-efficient code, but be sure, the JVM is usually good enough to 
optimize such things really well. 


4.1.8 Conditional jumps 


Now let's proceed to conditional jumps. 


public class abs 


{ 
public static int abs(int a) 
{ 
if (a«0) 
return -a; 
return a; 
} 
} 


public static int abs(int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack=1, locals-1, args size-1 
: iload 0 
ifge 7 
iload 0 
ineg 
ireturn 
iload 0 
ireturn 


0 -4oUii»Hn|Go 


ifge jumps to offset 7 if the value at TOS is greater or equal to 0. 

Don't forget, any ifXX instruction pops the value (to be compared) from the stack. 
ineg just negates value at TOS. 

Another example: 


public static int min (int a, int b) 
{ 
if (a>b) 
return b; 
return a; 
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We get: 


public static int min(int, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-2, locals-2, args size-2 
: iload 0 
iload 1 
if icmple 7 
iload 1 
ireturn 
iload 0 
ireturn 
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if icmple pops two values and compares them. If the second one is lesser than (or 
equal to) the first, a jump to offset 7 is performed. 


When we define max() function ... 


public static int max (int a, int b) 
1 
if (a>b) 
return a; 
return b; 


...the resulting code is the same, but the last two iload instructions (at offsets 5 
and 7) are swapped: 


public static int max(int, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-2, locals-2, args size-2 
: iload 0 
iload 1 
if icmple 7 
iload 0 
ireturn 
iload 1 
ireturn 
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A more advanced example: 


public class cond 


1 
public static void f(int i) 
1 
if (i«100) 
System.out.print("«100"); 
if (i--100) 
System.out.print("==100"); 
if (i>100) 
System.out.print(">100"); 
if (i==0) 
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System.out.print("==0"); 


public static void f(int); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-1, args size-1 

0: iload 0 

1: bipush 100 

3: if icmpge 14 

6: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

9: ldc #3 // String <100 

11: invokevirtual #4 // Method java/io/PrintStream.print: (2 
y Ljava/lang/String;)V 

14: iload 0 

15: bipush 100 

17: if icmpne 28 

20: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

23: ldc #5 // String ==100 

25: invokevirtual #4 // Method java/io/PrintStream.print: (7 
y Ljava/lang/String;)V 

28: iload 0 

29: bipush 100 

31: if icmple 42 

34: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

37: ldc #6 // String >100 

39: invokevirtual #4 // Method java/io/PrintStream.print: (7 
y Ljava/lang/String;)V 

42: iload 0 

43: ifne 54 

46: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

49: ldc 37 // String == 

51: invokevirtual £4 // Method java/io/PrintStream.print:(7/ 
y Ljava/lang/String;)V 

54: return 


if icmpge pops two values and compares them. If the second one is larger or equal 
than the first, a jump to offset 14 is performed. 


if icmpne and if icmple work just the same, but implement different conditions. 
There is also a ifne instruction at offset 43. 


Its name is misnomer, it would've be better to name it ifnz (jump if the value at 
TOS is not zero). 


And that is what it does: it jumps to offset 54 if the input value is not zero. 


If zero,the execution flow proceeds to offset 46, where the “==0” string is printed. 
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N.B.: JVM has no unsigned data types, so the comparison instructions operate only 
on signed integer values. 


4.1.9 Passing arguments 


Let's extend our min()/max() example: 


public class minmax 


1 
public static int min (int a, int b) 
1 
if (a»b) 
return b; 
return a; 
} 
public static int max (int a, int b) 
{ 
if (a>b) 
return a; 
return b; 
} 
public static void main(String[] args) 
{ 
int a=123, b=456; 
int max_value=max(a, b); 
int min_value=min(a, b); 
System.out.println(min value); 
System.out.println(max value); 
} 
} 


Here is main () function code: 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals=5, args size-1 

0: bipush 123 
2: istore 1 
3: sipush 456 
6: istore 2 
7: iload 1 
8: iload 2 
9: invokestatic #2 // Method max: (II)I 
12: istore 3 
13: iload 1 
14: iload 2 
15: invokestatic #3 // Method min: (II)I 
18: istore 4 
20: getstatic #4 // Field java/lang/System.out:Ljava/io/^7 


s PrintStream; 
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23: iload 4 

25: invokevirtual #5 // Method java/io/PrintStream.println:(I^7 
y )V 

28: getstatic #4 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

31: iload 3 

32: invokevirtual #5 // Method java/io/PrintStream.println: (12 
SV 

35: return 


Arguments are passed to the other function in the stack, and the return value is left 
on TOS. 


4.1.10 Bitfields 


All bit-wise operations work just like in any other ISA: 


public static int set (int a, int b) 


{ 
return a | 1<<b; 
} 
public static int clear (int a, int b) 
{ 
return a & (~(1<<b)); 
} 


public static int set(int, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack=3, locals-2, args size-2 

: iload 0 

iconst 1 

iload 1 

ishl 

ior 

ireturn 
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public static int clear(int, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack=3, locals-2, args size=2 

: iload 0 

iconst 1 

iload 1 

ishl 

iconst ml 

ixor 

iand 

ireturn 
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iconst ml loads -1 in the stack, it's the same as the OxFFFFFFFF number. 
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XORing with OxFFFFFFFF has the same effect of inverting all bits. 
Let's extend all data types to 64-bit long: 


public static long lset (long a, int b) 


1 
return a | 1««b; 
} 
public static long lclear (long a, int b) 
{ 
return a & (-(1««b)); 
} 


public static long lset(long, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack-4, locals-3, args size-2 

: lload 0 

iconst 1 

iload 2 

ishl 

i2l 

lor 

lreturn 
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public static long lclear(long, int); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack-4, locals-3, args size-2 

: lload 0 

iconst 1 

iload 2 

ishl 

iconst ml 

ixor 

i2l 

land 

lreturn 
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The code is the same, but instructions with / prefix are used, which operate on 64-bit 
values. 


Also, the second argument type ofthe function is still int, and when the 32-bit value in 
it needs to be promoted to 64-bit value the i21 instruction is used, which essentially 
extend the value of an integer type to a long one. 


4.1.11 Loops 


public class Loop 


{ 


public static void main(String[] args) 


{ 
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for (int i = 1; i <= 10; i++) 


{ 
} 


System.out.println(i); 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-2, args size-1 

0: iconst 1 

1: istore 1 

2: iload 1 

3: bipush 10 

5: if icmpgt 21 

8: getstatic #2 // Field java/lang/System.out:Ljava/iov 
y /PrintStream; 

11: iload 1 

12: invokevirtual £3 // Method java/io/PrintStream.println 
S :(I)V 

15: iinc 1, 1 

18: goto 2 

21: return 


iconst_1 loads 1 into TOS, istore 1 stores it in the LVA at slot 1. 


Why not the zeroth slot? Because the main() function has one argument (array of 
String) and a pointer to it (or reference) is now in the zeroth slot. 


So, the i local variable will always be in 1st slot. 

Instructions at offsets 3 and 5 compare i with 10. 

If iis larger, execution flow passes to offset 21, where the function ends. 
If it’s not, println is called. 

i is then reloaded at offset 11, for println. 


By the way, we call the println method for an integer, and we see this in the com- 
ments: “(I)V” (I means integer and V means the return type is void). 


When println finishes, i is incremented at offset 15. 


The first operand of the instruction is the number of a slot (1), the second is the 
number (1) to add to the variable. 


goto is just GOTO, it jumps to the beginning of the loop's body offset 2. 


Let's proceed with a more complex example: 


public class Fibonacci 
1 
public static void main(String[] args) 


1 
int limit = 20, f =0, g= 1; 
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for (int i = 1; i <= limit; i++) 


{ 
f-f-*9g; 
g-f-g 
System.out.println(f); 
) 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack=2, locals=5, args size-1 
: bipush 20 
istore 1 
iconst 0 
istore 2 
iconst 1 
istore 3 
iconst 1 
istore 4 
: iload 4 
: iload 1 
: if icmpgt 37 
: iload 2 
: iload 3 
: iadd 
: istore 2 
: iload 2 
21: iload 3 
22: isub 
23: istore 3 
24: getstatic #2 // Field java/lang/System.out:Ljava/iov 
y /PrintStream; 
27: iload 2 
28: invokevirtual #3 // Method java/io/PrintStream.println 
S :(I)V 
31: iinc 4, 1 
34: goto 10 
37: return 
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Here is a map of the LVA slots: 
e 0— the sole argument of main() 


e 1 — limit, always contains 20 


-2—f 
. 3—9 
-4A—i 
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We can see that the Java compiler allocates variables in LVA slots in the same order 
they were declared in the source code. 


There are separate istore instructions for accessing slots 0, 1, 2 and 3, but not for 
4 and larger, so there is istore with an additional operand at offset 8 which takes 
the slot number as an operand. 


It's the same with iload at offset 10. 


But isn't it dubious to allocate another slot for the /imit variable, which always con- 
tains 20 (so it's a constant in essence), and reload its value so often? 


JVM JIT compiler is usually good enough to optimize such things. 


Manual intervention in the code is probably not worth it. 


4.1.12 switch() 


The switch() statement is implemented with the tableswitch instruction: 


public static void f(int a) 


{ 
Switch (a) 
{ 
case 0: System.out.println("zero"); break; 
case 1: System.out.println("one\n"); break; 
case 2: System.out.println("two\n"); break; 
case 3: System.out.println("three\n"); break; 
case 4: System.out.println("four\n"); break; 
default: System.out.println("something unknown\n"); break; 
h 

} 


As simple, as possible: 


public static void f(int); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-1, args size-1 
0: iload 0 
1: tableswitch (//0 to 4 
0: 36 
1: 47 
2: 58 
3: 69 
4: 80 
default: 91 
} 
36: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 
39: ldc #3 // String zero 
41: invokevirtual #4 // Method java/io/PrintStream.println: (7 
y Ljava/lang/String;)V 
44: goto 99 
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47: getstatic #2 // Field java/lang/System.out:Ljava/io// 
y PrintStream; 

50: ldc 35 // String one\n 

52: invokevirtual £4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

55: goto 99 

58: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

61: ldc #6 // String two\n 

63: invokevirtual #4 // Method java/io/PrintStream.println: (7 
y Ljava/lang/String;)V 

66: goto 99 

69: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

72: ldc 37 // String three\n 

74: invokevirtual #4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

77: goto 99 

80: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

83: ldc #8 // String four\n 

85: invokevirtual #4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

88: goto 99 

91: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

94: ldc #9 // String something unknown\n 

96: invokevirtual #4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

99: return 


4.1.13 Arrays 
Simple example 


Let’s first create an array of 10 integers and fill it: 


public static void main(String[] args) 


{ 
int a[]=new int[10]; 
for (int i20; i«10; i++) 
alil=i; 
dump (a); 
} 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=3, locals-3, args size-1 
0: bipush 10 
2: newarray int 


4: astore 1 
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5: iconst 0 

6: istore 2 

7: iload 2 

8: bipush 10 
10: if icmpge 23 
13: aload 1 

14: iload 2 

15: iload 2 

16: iastore 

17: iinc 2, 1 
20: goto 7 
23: aload 1 

24: invokestatic #4 // Method dump: ([I)V 
27: return 


The newarray instruction creates an array object of 10 int elements. 
The array’s size is set with bipush and left at TOS. 
The array’s type is set in newarray instruction’s operand. 


After newarray’s execution, a reference (or pointer) to the newly created array in 
the heap is left at the TOS. 


astore 1 stores the reference to the 1st slot in LVA. 


The second part of the main() function is the loop which stores i into the correspond- 
ing array element. 


aload 1 gets a reference of the array and places it in the stack. 


iastore then stores the integer value from the stack in the array, reference of which 
is currently in TOS. 


The third part of the main() function calls the dump() function. 
An argument for it is prepared by aload 1 (offset 23). 
Now let's proceed to the dump() function: 


public static void dump(int a[]) 
1 
for (int i20; i«a.length; i++) 
System.out.println(a[i]); 


public static void dump(int[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack=3, locals-2, args size-1 

: iconst 0 

istore 1 

iload 1 

aload 0 

arraylength 

if icmpge 23 


Ui == 0) NJ HG. © 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


862 


8: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

11: aload 0 

12: iload 1 

13: iaload 

14: invokevirtual £3 // Method java/io/PrintStream.println: (I) 7 


17: iinc 1, 1 
20: goto 2 
23: return 


The incoming reference to the array is in the zeroth slot. 


The a. Length expression in the source code is converted to an arraylength instruc- 
tion: it takes a reference to the array and leaves the array size at TOS. 


iaload at offset 13 is used to load array elements, it requires an array reference to 
be present in the stack (prepared by aload 0 at 11), and also an index (prepared by 
iload 1 at offset 12). 


Needless to say, instructions prefixed with a may be mistakenly comprehended as 
array instructions. 


It's not correct. These instructions works with references to objects. 


And arrays and strings are objects too. 


Summing elements of array 


Another example: 


public class ArraySum 


1 
public static int f (int[] a) 
1 
int sum-0; 
for (int i20; i«a.length; i++) 
sum=sum+a[i]; 
return sum; 
} 
} 


public static int f(int[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack=3, locals-3, args size-1 

: iconst 0 

istore 1 

iconst 0 

istore 2 

iload 2 

aload 0 

arraylength 

if icmpge 22 
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10: iload 1 
11: aload 0 
12: iload 2 
13: iaload 
14: iadd 

15: istore 1 
16: iinc 

19: goto 4 
22: iload 1 

23: ireturn 


N 
m. 


LVA slot O contains a reference to the input array. 


LVA slot 1 contains the local variable sum. 


The only argument of the main() function is an array too 


We'll be using the only argument of the main() function, which is an array of strings: 


public class UseArgument 


{ 
public static void main(String[] args) 
{ 
System.out.print("Hi, "); 
System.out.print(args[1]); 
System.out.println(". How are you?"); 
} 
} 


The zeroth argument is the program's name (like in C/C+ +, etc.), so the 1st argument 
supplied by the user is 1st. 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=3, locals-1, args size-1 

0: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

3: ldc #3 // String Hi, 

5: invokevirtual #4 // Method java/io/PrintStream.print: (7 
y Ljava/lang/String;)V 

8: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
S PrintStream; 

11: aload 0 

12: iconst 1 

13: aaload 

14: invokevirtual £4 // Method java/io/PrintStream.print: (7 
y Ljava/lang/String;)V 

17: getstatic #2 // Field java/lang/System.out:Ljava/io/ / 
y PrintStream; 

20: ldc #5 // String . How are you? 

22: invokevirtual #6 // Method java/io/PrintStream.println:(7 


y Ljava/lang/String;)V 
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25: return 


aload 0 at 11 loads a reference of the zeroth LVA slot (1st and only main() argu- 


ment). 


iconst 1 and aaload at 12 and 13 take a reference to the first (counting at 0) ele- 


ment of array. 


The reference to the string object is at TOS at offset 14, and it is taken from there 


by println method. 


Pre-initialized array of strings 


class Month 
{ 
public static String[] months = 
{ 
"January", 
"February", 
"March", 


"July", 

"August", 

"September", 

"October", 

"November", 

"December" 
un 


public String get month (int i) 
1 


un 


return months[i]; 


The get month() function is simple: 


public java.lang.String get month(int); 
flags: ACC PUBLIC 


Code: 
stack-2, locals-2, args size-2 
0: getstatic #2 
3: iload 1 
4: aaload 
5: areturn 


// Field months: [Ljava/lang/String; 


aaload operates on an array of references. 


Java String are objects, so the a-instructions are used to operate on them. 


areturn returns a reference to a String object. 
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How is the months[] array initialized? 


static {}; 
flags: ACC STATIC 
Code: 


stack-4, locals=0, args size=0 


: bipush 
anewarray 
dup 
iconst 0 
ldc 
aastore 
: dup 

: iconst 1 
: ldc 

: aastore 
: dup 

: iconst 2 
: ldc 

: aastore 
: dup 

21: iconst 3 
22: ldc 

24: aastore 
25: dup 

26: iconst 4 
27: ldc 

29: aastore 
30: dup 

31: iconst 5 
32: ldc 

34: aastore 
35: dup 

36: bipush 
38: ldc 

40: aastore 
41: dup 

42: bipush 
44: ldc 

46: aastore 
47: dup 

48: bipush 
50: ldc 

52: aastore 
53: dup 

54: bipush 
56: ldc 

58: aastore 
59: dup 

60: bipush 
62: ldc 

64: aastore 
65: dup 

66: bipush 
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68: ldc #15 // String December 

70: aastore 

71: putstatic #2 // Field months: [Ljava/lang/String; 
74: return 


anewarray creates a new array of references (hence a prefix). 


The object’s type is defined in the anewarray’s operand, it is the 
“java/lang/String” string. 


The bipush 12 before anewarray sets the array’s size. 
We see here a new instruction for us: dup. 


It’s a standard instruction in stack computers (including the Forth programming lan- 
guage) which just duplicates the value at TOS. 


By the way, FPU 80x87 is also a stack computer and it has similar instruction - FDUP. 


It is used here to duplicate a reference to an array, because the aastore instruction 
pops the reference to array from the stack, but subsequent aastore will need it 
again. 


The Java compiler concluded that it's better to generate a dup instead of generating 
a getstatic instruction before each array store operation (i.e., 11 times). 


aastore puts a reference (to string) into the array at an index which is taken from 
TOS. 


Finally, putstatic puts reference to the newly created array into the second field of 
our object, i.e., months field. 


Variadic functions 


Variadic functions actually use arrays: 


public static void f(int... values) 


{ 
for (int i=0; i«values.length; i++) 
System.out.println(values[il); 


} 
public static void main(String[] args) 
{ 
f (1,2,3,4,5); 
} 


public static void f(int...); 
flags: ACC PUBLIC, ACC STATIC, ACC VARARGS 
Code: 
stack=3, locals-2, args size-1 

0: iconst 0 
1: istore 1 
2: iload 1 
3: aload 0 
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4: arraylength 


5: if icmpge 23 

8: getstatic #2 // Field java/lang/System.out:Ljava/io// 
y PrintStream; 

11: aload 0 

12: iload 1 

13: iaload 

14: invokevirtual £3 // Method java/io/PrintStream.println: (1, 
S )V 

17: iinc 1; 

20: goto 2 

23: return 


f() just takes an array of integers using aload 0 at offset 3. 
Then it gets the array's size, etc. 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-4, locals-1, args size-1 

0: iconst 5 
1: newarray int 
3: dup 

4: iconst 0 
5: iconst 1 
6: iastore 
7: dup 

8: iconst 1 
9: iconst 2 
10: iastore 
11: dup 

12: iconst 2 
13: iconst 3 
14: iastore 
15: dup 

16: iconst 3 
17: iconst 4 
18: iastore 
19: dup 
20: iconst 4 


21: iconst 5 

22: iastore 

23: invokestatic #4 // Method f:([I)V 
26: return 


The array is constructed in main() using the newarray instruction, then it's filled, 


and f () is called. 


Oh, by the way, array object is not destroyed at the end of main(). 


There are no destructors in Java at all, because the JVM has a garbage collector which 


does this automatically, when it feels it needs to. 
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What about the format() method? 


It takes two arguments at input: a string and an array of objects: 


public PrintStream format(String format, Object... args) 


( http://docs.oracle.com/javase/tutorial/java/data/numberformat.html ) 


Let's see: 
public static void main(String[] args) 
1 
int i-123; 
double d=123.456; 
System.out.format("int: %d double: %f.%n", i, d); 
} 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-7, locals-4, args size-1 
0: bipush 123 
2: istore 1 
3: ldc2 w #2 // double 123.456d 
6: dstore 2 
7: getstatic #4 // Field java/lang/System.out:Ljava/io7 
4 /PrintStream; 
10: ldc #5 // String int: %d double: %f.%n 
12: iconst 2 
13: anewarray #6 // class java/lang/Object 
16: dup 
17: iconst_0 
18: iload 1 
19: invokestatic #7 // Method java/lang/Integer.value0f: (Iv 
y )Ljava/lang/Integer; 
22: aastore 
23: dup 
24: iconst 1 
25: dload 2 
26: invokestatic #8 // Method java/lang/Double.valueOf:(D)7 
s Ljava/lang/Double; 
29: aastore 
30: invokevirtual #9 // Method java/io/PrintStream. format: (7 
y Ljava/lang/String; [Ljava/lang/0bject;)Ljava/io/PrintStream; 
33: pop 
34: return 


So values of the int and double types are first promoted to Integer and Double 
objects using the valueOf methods. 


The format() method needs objects of type Object at input, and since the Integer 
and Double classes are derived from the root Object class, they suitable for ele- 
ments in the input array. 
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On the other hand, an array is always homogeneous, i.e., it can't hold elements of 
different types, which makes it impossible to push int and double values in it. 


An array of Object objects is created at offset 13, an Integer object is added to the 
array at offset 22, and a Double object is added to the array at offset 29. 


The penultimate pop instruction discards the element at TOS, so when return is 
executed, the stack becomes empty (or balanced). 


Two-dimensional arrays 


Two-dimensional arrays in Java are just one-dimensional arrays of references to an- 
other one-dimensional arrays. 


Let's create a two-dimensional array: 


public static void main(String[] args) 


- new int[5][10]; 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack-3, locals-2, args size-1 
0: iconst 5 
1: bipush 10 
3: multianewarray #2, 2 // class "[[I" 
7: astore 1 
8: aload 1 
9: iconst 1 
10: aaload 
11: iconst 2 
12: iconst 3 
13: iastore 
14: return 


It's created using the mul tianewarray instruction: the object's type and dimension- 
ality are passed as operands. 


The array's size (10*5) is left in stack (using the instructions iconst 5 and bipush). 
A reference to row #1 is loaded at offset 10 (iconst 1 and aaload). 

The column is chosen using iconst 2 at offset 11. 

The value to be written is set at offset 12. 

iastore at 13 writes the array's element. 


How it is an element accessed? 


public static int get12 (int[][] in) 
{ 


return in[1][2]; 
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public static int get12(int[][]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack-2, locals-1, args size-1 

: aload 0 

iconst 1 

aaload 

iconst 2 

iaload 

ireturn 
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A Reference to the array's row is loaded at offset 2, the column is set at offset 3, 
then iaload loads the array's element. 
Three-dimensional arrays 


Three-dimensional arrays are just one-dimensional arrays of references to one-dimensional 
arrays of references to one-dimensional arrays. 


public static void main(String[] args) 


{ 
int[][][] a = new int[5][10][15]; 
a[11[21[31=4; 
get elem(a); 

} 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 
Code: 
stack=3, locals-2, args size-1 

0: iconst 5 
1: bipush 10 

3: bipush 15 
5: multianewarray 42, 3 // class "[[[I" 
9: astore 1 

10: aload 1 

11: iconst 1 

12: aaload 

13: iconst 2 

14: aaload 

15: iconst 3 

16: iconst 4 

17: iastore 

18: aload 1 

19: invokestatic #3 // Method get elem: ([[[I)I 

22: pop 

23: return 
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Now it takes two aaload instructions to find right reference: 


public static int get elem (int[][][] a) 
1 


) 


return a[1][2][3]; 


public static int get elem(int[1[1[1); 
flags: ACC PUBLIC, ACC STATIC 
Code: 

stack-2, locals-1, args size-1 

: aload 0 

iconst 1 

aaload 

iconst 2 

aaload 

iconst 3 

iaload 

ireturn 
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Summary 


Is it possible to do a buffer overflow in Java? 


No, because the array's length is always present in an array object, array bounds 
are controlled, and an exception is to be raised in case of out-of-bounds access. 


There are no multi-dimensional arrays in Java in the C/C++ sense, so Java is not very 
suited for fast scientific computations. 


4.1.14 Strings 


First example 


Strings are objects and are constructed in the same way as other objects (and ar- 
rays). 


public static void main(String[] args) 


1 
System.out.println("What is your name?"); 
String input = System.console().readLine(); 
System.out.println("Hello, "+input) ; 

} 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=3, locals=2, args size=1 
0: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 
3: ldc #3 // String What is your name? 
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5: invokevirtual £4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

8: invokestatic #5 // Method java/lang/System.console:()7 
S Ljava/io/Console; 

11: invokevirtual £6 // Method java/io/Console.readLine:()7 


S Ljava/lang/String; 
14: astore 1 


15: getstatic #2 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

18: new #7 // class java/lang/StringBuilder 

21: dup 

22: invokespecial #8 // Method java/lang/StringBuilder. "</ 
S init>":()V 

25: ldc #9 // String Hello, 

27: invokevirtual #10 // Method java/lang/StringBuilder. 2 
y append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

30: aload_1 

31: invokevirtual +10 // Method java/lang/StringBuilder. / 
y append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

34: invokevirtual +11 // Method java/lang/StringBuilder. 7 
y toString: ()Ljava/lang/String; 

37: invokevirtual #4 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

40: return 


The readLine() method is called at offset 11, a reference to string (which is supplied 
by the user) is then stored at TOS. 


At offset 14 the reference to string is stored in slot 1 of LVA. 


The string the user entered is reloaded at offset 30 and concatenated with the "Hello, 
" string using the StringBuilder class. 


The constructed string is then printed using println at offset 37. 


Second example 


Another example: 


public class strings 


{ 
public static char test (String a) 
{ 
return a.charAt(3); 
$; 
public static String concat (String a, String b) 
1 
return a+b; 
} 
} 


public static char test(java.lang.String) ; 
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flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-2, locals-1, args size-1 
0: aload 0 
1: iconst 3 
2: invokevirtual #2 // Method java/lang/String.charAt: (I)C 
5: ireturn 


The string concatenation is performed using StringBuilder: 


public static java.lang.String concat(java.lang.String, java.lang.String) 
Gs 


flags: ACC PUBLIC, ACC_STATIC 
Code: 
stack=2, locals=2, args_size=2 

0: new #3 // class java/lang/StringBuilder 

3: dup 

4: invokespecial #4 // Method java/lang/StringBuilder."</ 
S init>":()V 

7: aload 0 

8: invokevirtual #5 // Method java/lang/StringBuilder. 7 
ú append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

11: aload 1 

12: invokevirtual #5 // Method java/lang/StringBuilder. / 
y append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

15: invokevirtual £6 // Method java/lang/StringBuilder. 7 


y toString: ()Ljava/lang/String; 
18: areturn 


Another example: 


public static void main(String[] args) 


{ 

String s="Hello!"; 

int n=123; 

System.out.println("sz" + s + " n=" + n); 
} 


And again, the strings are constructed using the StringBuilder class and its append 
method, then the constructed string is passed to println: 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=3, locals=3, args size=1 

0: dc #2 // String Hello! 

2: astore 1 

3: bipush 123 

5: istore 2 

6: getstatic 33 // Field java/lang/System.out:Ljava/io// 
y PrintStream; 

9: new #4 // class java/lang/StringBuilder 

12: dup 
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13: invokespecial #5 // Method java/lang/StringBuilder. "</ 
S init>":()V 

16: ldc #6 // String s= 

18: invokevirtual #7 // Method java/lang/StringBuilder. 7 
ú append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

21: aload 1 

22: invokevirtual £7 // Method java/lang/StringBuilder. / 
y append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

25: ldc #8 // String n= 

27: invokevirtual #7 // Method java/lang/StringBuilder. 7 
ú append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

30: iload 2 

31: invokevirtual £9 // Method java/lang/StringBuilder. 2 
y append: (I)Ljava/lang/StringBuilder; 

34: invokevirtual £10 // Method java/lang/StringBuilder. 7 
y toString: ()Ljava/lang/String; 

37: invokevirtual #11 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

40: return 


4.1.15 Exceptions 
Let's rework our Month example (4.1.13 on page 864) a bit: 


Listing 4.10: IncorrectMonthException.java 


public class IncorrectMonthException extends Exception 


1 
private int index; 
public IncorrectMonthException(int index) 
1 
this.index = index; 
public int getIndex() 
1 
return index; 
} 
} 


Listing 4.11: Month2.java 


class Month2 
{ 
public static String[] months = 
{ 
"January", 
"February", 
"March", 
"April", 
"May" ; 
"June" i 
"July" i 
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"August", 
"September", 
"October", 
"November", 
"December" 


}; 


public static String get month (int i) throws 2 
S IncorrectMonthException 


{ 
if (i«0 || i>11) 
throw new IncorrectMonthException(i); 
return months[i]; 
i 
public static void main (String[] args) 
{ 
try 
{ 
System. out.println(get_month(100) ); 
} 
catch(IncorrectMonthException e) 
{ 


System.out.println("incorrect month index: "+ e.z 
y getIndex()); 
e.printStackTrace(); 
} 
$; 


Essentially, IncorrectMonthException.class has just an object constructor and 
one getter method. 


The IncorrectMonthException class is derived from Exception, sothe IncorrectMonthException 
constructor first calls the constructor of the Exception class, then it puts incoming 
integer value into the sole IncorrectMonthException class field: 


public IncorrectMonthException(int); 
flags: ACC PUBLIC 
Code: 
stack-2, locals-2, args size-2 

0: aload 0 
1: invokespecial £1 // Method java/lang/Exception."<init/ 

g >":()V 
4: aload 0 
5: iload_1 
6: putfield #2 // Field index:I 
9: return 


getIndex() is just a getter. A reference to IncorrectMonthException is passed in 
the zeroth LVA slot (this), aload 0 takes it, getfield loads an integer value from 
the object, ireturn returns it. 
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public int getIndex(); 
flags: ACC PUBLIC 


Code: 
stack=1, locals-1, args size-1 
0: aload 0 
1: getfield #2 // Field index:I 
4: ireturn 


Now let's take a look at get month() in Month2.class: 


Listing 4.12: Month2.class 


public static java.lang.String get month(int) throws 7 

s IncorrectMonthException; 

flags: ACC PUBLIC, ACC STATIC 

Code: 

stack=3, locals-1, args size-1 

0: iload 0 
1: iflt 10 
4: iload 0 
5: bipush 11 
7: if icmple 19 
10: new #2 // class IncorrectMonthException 
13: dup 
14: iload 0 
15: invokespecial £3 // Method IncorrectMonthException. "</ 

S init>":(1)V 
18: athrow 
19: getstatic 34 // Field months: [Ljava/lang/String; 
22: iload 0 
23: aaload 
24: areturn 


iflt at offset 1 is if less than. 


In case of invalid index, a new object is created using the new instruction at offset 
10. 


The object's type is passed as an operand to the instruction (which is IncorrectMonthException). 
Then its constructor is called, and index is passed via TOS (offset 15). 


When the control flow is offset 18, the object is already constructed, so now the 
athrow instruction takes a reference to the newly constructed object and signals to 
JVM to find the appropriate exception handler. 


The athrow instruction doesn't return the control flow here, so at offset 19 there 
is another basic block, not related to exceptions business, where we can get from 
offset 7. 


How do handlers work? 


main() in Month2.class: 


Listing 4.13: Month2.class 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


877 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-3, locals-2, args size-1 

0: getstatic #5 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

3: bipush 100 

5: invokestatic #6 // Method get_month: (I)Ljava/lang/ z 
S String; 

8: invokevirtual #7 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

11: goto 47 

14: astore 1 

15: getstatic #5 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

18: new #8 // class java/lang/StringBuilder 

21: dup 

22: invokespecial #9 // Method java/lang/StringBuilder. "</ 
S init>":()V 

25: ldc #10 // String incorrect month index: 

27: invokevirtual #11 // Method java/lang/StringBuilder. 7 
s append: (Ljava/lang/String;)Ljava/lang/StringBuilder; 

30: aload 1 

31: invokevirtual #12 // Method IncorrectMonthException. 2 
y getIndex:()I 

34: invokevirtual £13 // Method java/lang/StringBuilder. 7 
y append: (I)Ljava/lang/StringBuilder; 

37: invokevirtual #14 // Method java/lang/StringBuilder. 7 
y toString: ()Ljava/lang/String; 

40: invokevirtual #7 // Method java/io/PrintStream.println: (2 
y Ljava/lang/String;)V 

43: aload 1 

44: invokevirtual £15 // Method IncorrectMonthException. ? 
V printStackTrace:()V 

47: return 


Exception table: 
from to target type 
0 11 14 Class IncorrectMonthException 


Here is the Exception table, which defines that from offsets O to 11 (inclusive) an 
exception 

IncorrectMonthException may happen, and if it does, the control flow is to be 
passed to offset 14. 


Indeed, the main program ends at offset 11. 


At offset 14 the handler starts. It's not possible to get here, there are no condition- 
al/unconditional jumps to this area. 


But JVM will transfer the execution flow here in case of an exception. 


The very first astore 1 (at 14) takes the incoming reference to the exception object 
and stores it in LVA slot 1. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


878 
Later, the getIndex() method (of this exception object) will be called at offset 31. 


The reference to the current exception object is passed right before that (offset 30). 


The rest of the code is does just string manipulation: first the integer value returned 
by getIndex() is converted to string by the toString() method, then it's concate- 
nated with the "incorrect month index: " text string (like we saw before), then 
println() and printStackTrace() are called. 


After printStackTrace() finishes, the exception is handled and we can continue 
with the normal execution. 


At offset 47 there is a return which finishes the main() function, but there could be 
any other code which would execute as if no exceptions were raised. 


Here is an example on how IDA shows exception ranges: 


Listing 4.14: from some random .class file found on the author's computer 


.catch java/io/FileNotFoundException from met001 335 to met001 360\ 
using met001 360 
.catch java/io/FileNotFoundException from met001 185 to met001 214\ 
using met001 214 
.catch java/io/FileNotFoundException from met001 181 to met001 192\ 
using met001 195 
.catch java/io/FileNotFoundException from met001 155 to met001 176\ 
using met001 176 
.catch java/io/FileNotFoundException from met001 83 to met001 129 using 
GoN 
met001_129 
.catch java/io/FileNotFoundException from met001 42 to met001 66 using 2 
SN 
met001 69 
.catch java/io/FileNotFoundException from met001 begin to met001 37N 
using met001 37 


4.1.16 Classes 
Simple class: 


Listing 4.15: test.java 


public class test 


1 
public static int a; 
private static int b; 


public test() 


{ 
a=0; 
b=0; 
} 
public static void set_a (int input) 
{ 


a=input; 
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} 
public static int get_a () 


{ 


return a; 


public static void set_b (int input) 


{ 
b=input; 
} 
public static int get_b () 
{ 
return b; 
} 


The constructor just sets both fields to zero: 


public test(); 
flags: ACC PUBLIC 


Code: 
stack-1, locals-1, args size-1 

0: aload 0 
1: invokespecial £1 // Method java/lang/Object."<init>":() 7 

GV 
4: iconst_0 
5: putstatic #2 // Field a:I 
8: iconst 0 
9: putstatic #3 // Field b:I 
12: return 

Setter of a: 


public static void set a(int); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack-1, locals-1, args size-1 
0: iload 0 
1: putstatic #2 // Field a:I 
4: return 
Getter of a: 


public static int get a(); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals=0, args size=0 
0: getstatic #2 // Field a:I 
3: ireturn 
Setter of b: 


public static void set_b(int); 
flags: ACC PUBLIC, ACC STATIC 
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Code: 
stack=1, locals-1, args size-1 
0: iload 0 
1: putstatic 33 // Field b:I 
4: return 
Getter of b: 


public static int get b(); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=1, locals=0, args size-0 
0: getstatic #3 // Field b:I 
3: ireturn 


There is no difference in the code which works with public and private fields. 


But this type information is present in the . class file, and it's not possible to access 
private fields from everywhere. 


Let's create an object and call its method: 


Listing 4.16: ex1.java 


public class exl 


1 
public static void main(String[] args) 
1 
test obj=new test(); 
obj.set a (1234); 
System.out.println(obj.a); 
} 
} 


public static void main(java.lang.String[]); 
flags: ACC PUBLIC, ACC STATIC 


Code: 
stack=2, locals=2, args_size=1 

0: new #2 // class test 

3: dup 

4: invokespecial #3 // Method test."<init>":()V 

7: astore 1 

8: aload 1 

9: pop 

10: sipush 1234 

13: invokestatic #4 // Method test.set a:(I)V 

16: getstatic #5 // Field java/lang/System.out:Ljava/io/7 
y PrintStream; 

19: aload 1 

20: pop 

21: getstatic 3*6 // Field test.a:I 

24: invokevirtual #7 // Method java/io/PrintStream.println: (2 
S I)V 

27: return 
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The new instruction creates an object, but doesn't call the constructor (it is called at 
offset 4). 


The set a() method is called at offset 16. 


The a field is accessed using the getstatic instruction at offset 21. 


4.1.17 Simple patching 
First example 


Let's proceed with a simple code patching task. 


public class nag 


1 
public static void nag screen() 
1 
System.out.println("This program is not registered"); 
y; 
public static void main(String[] args) 
1 
System.out.println("Greetings from the mega-software"); 
nag screen(); 
} 
} 


How would we remove the printing of “This program is not registered” string? 


Let's load the .class file into IDA: 


; Segnent type: Pure code 
-method public static nag screen()U 
-limit stack 2 
-line 4 
getstatic java/lang/System.out Ljava/io/PrintStream; ; CODE XREF: main+8yP 


. 
E 
mJ 
e 
o 
© 
© 
e 
D 
N 


* 1918 603 ldc "This program is not registered" 

* (182 608 904 invokevirtual jaua/io/PrintStream.printin(Ljava/lang/String;)U 
-line 5 

* (177 return 


. 
X 
RJ 
» 
> 
X 
RJ 
X 
> 
MJ 
+ 


oP? 888 TTT -end method 


; Segment type: Pure code 
-method public static main([Ljava/lang/String;)U 
-limit stack 2 
-limit locals 1 


-line 8 

* 78 008 882 getstatic java/lang/System.out Ljava/io/PrintStream; 

* |e18 885 lde "Greetings from the mega-software" 

* 82 600 094 invokevirtual java/io/PrintStream.printin(Ljava/lang/String;)U 
-line 9 

* 184 000 006 invokestatic nag.nag screen()U 
-line 18 

e 1177 return 


Figure 4.1: IDA 
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Let's patch the first byte of the function to 177 (which is the return instruction's 
opcode): 


; Segment type: Pure code 
-method public static nag screen()U 
-limit stack 2 


| .line 4 
nag screen: ; CODE XREF: main+8yP 
e la77 return 
* jose 
* |ge2 
* |p18 863 ldc "This program is not registered" 
* (182 0009 605 invokevirtual java/io/PrintStream.println(Ljava/lang/String;)U 
-line 5 

M 77 return 


2 [222 ??? ???* „end method 


Figure 4.2: IDA 


But that doesn't work (JRE 1.7): 


Exception in thread "main" java.lang.VerifyError: Expecting a stack map 7 
S frame 
Exception Details: 
Location: 
nag.nag screen()V Q1: nop 
Reason: 
Error exists in the bytecode 
Bytecode: 
0000000: b100 0212 03b6 0004 b1 


at java.lang.Class.getDeclaredMethodsO(Native Method) 

at java.lang.Class.privateGetDeclaredMethods(Class.java:2615) 

at java.lang.Class.getMethod0(Class.java:2856) 

at java.lang.Class.getMethod(Class.java:1668) 

at sun. launcher.LauncherHelper.getMainMethod(LauncherHelper.java2 
S :494) 

at sun. launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.javaZ 
S :486) 


Perhaps JVM has some other checks related to the stack maps. 
OK, let's patch it differently by removing the call to nag(): 
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; Segment type: Pure code 
-method public static main([Ljava/lang/String;)U 
-limit stack 2 
-limit locals 1 


-line 8 

* (178 600 082 getstatic java/lang/System.out Ljava/io/PrintStream; 

* 1018 905 ldc “Greetings from the mega-software" 

* 82 000 964 invokevirtual java/io/PrintStream.printin(Ljava/lang/String; )U 
-line 9 

* (008 nop 

* (088 nop 

* [ooo nop 
-line 18 

* 77 return 


Figure 4.3: IDA 


O is the opcode for NOP. 
Now that works! 


Second example 


Another simple crackme example: 


public class password 


1 
public static void main(String[] args) 
1 
System.out.println("Please enter the password"); 
String input = System.console().readLine(); 
if (input.equals("secret")) 
System.out.println("password is correct"); 
else 
System.out.println("password is not correct"); 
} 
} 


Let's load it in IDA: 
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; Segment type: Pure code 
-method public static main([Ljava/lang/String;)U 
-limit stack 2 
-limit locals 2 


-line 3 
2 [178 966 002 getstatic java/lang/System.out Ljava/io/PrintStream; 
* |e18 083 ldc "Please enter the password" 
* [82 008 004 invokevirtual java/io/PrintStream.printin(Ljava/lang/String;)U 
-line 4 
? 84 6080 805 invokestatic java/lang/System.console()Ljava/io/Console; 
* 82 688 006 invokevirtual java/io/Console.readLine()Ljava/lang/String; 
* (076 astore 1 ; met082_slot001 
-line 5 
* (043 aload 1 ; met8082 slot8001 
* 1018 087 lde "secret" 
* 82 6008 008 invokevirtual java/lang/String.equals(Ljava/lang/Übject;)2 
r--* (153 699 014 ifeq 
l -line ó 
ı © 178 688 002 getstatic java/lang/System.out Ljava/io/PrintStream; 
| © (818 609 ldc “password is correct" 
ı © H82 000 004 invokevirtual java/io/PrintStream.printin(Ljava/lang/String;)U 
| (167 008 011 goto met @62_43 
i -line 8 
I 
i : ; CODE XREF: main*211j 
' 178 666 662 -stack use locals 
i locals Object java/lang/String 
à .end stack 
E ds getstatic java/lang/System.out Ljava/io/PrintStream; 
* |p18 018 ldc "password is not correct" 
* 82 008 005 invokevirtual java/io/PrintStream.printin(Ljava/lang/String;)U 
-line 9 


Figure 4.4: IDA 


We see here the ifeq instruction which does the job. 


Its name stands for if equal, and this is misnomer, a better name would be ifz (if 
zero), i.e, if value at TOS is zero, then do the jump. 


In our example, it jumps if the password is not correct (the equals method returns 
False, which is 0). 


The very first idea is to patch this instruction. 
There are two bytes in ifeq opcode, which encode the jump offset. 


To make this instruction a NOP, we must set the 3rd byte to the value of 3 (because 
by adding 3 to the current address we will always jump to the next instruction, since 
the ifeq instruction's length is 3 bytes): 
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* (184 
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* (043 
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178 
* (018 
2 (182 
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178 
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883 
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887 
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889 
888 
888 


616 
888 


662 


664 
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886 


668 
663 


662 


664 
611 


662 
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; Segment type: Pure code 


-method public static main([Ljava/lang/String;)U 
-limit stack 2 
-limit locals 2 
-line 3 
getstatic java/lang/System.out Ljava/io/PrintStream; 
ldc "Please enter the password" 
invokevirtual jaua/io/PrintStream.printin(Ljava/lang/String;)U 
-line 4 
invokestatic java/lang/System.console()Ljava/io/Console; 
invokevirtual java/io/Console.readLine()Ljava/lang/String; 
astore 1 ; met882 slot801 
-line 5 
aload 1 ; met662_slot661 
ldc "secret" 
invokevirtual java/lang/String.equals(Ljava/lang/0bject;)2 
ifeq 
-line 6 


: ; CODE XREF: main+211j 
getstatic java/lang/System.out Ljava/io/PrintStream; 
ldc “password is correct" 
invokevirtual java/io/PrintStream.printin(Ljava/lang/String;)U 
goto met802 ^3 
-line 8 
-stack use locals 
locals Object java/lang/String 
-end stack 
getstatic java/lang/System.out Ljava/io/PrintStream; 
ldc “password is not correct" 
invokevirtual java/io/PrintStream.printin(Ljava/lang/String;)U 
-line 9 


Figure 4.5: IDA 


That doesn't work (JRE 1.7): 
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Exception in thread "main" java.lang.VerifyError: Expecting a stackmap 7 
V frame at branch target 24 
Exception Details: 


Location: 
password.main([Ljava/lang/String;)V Q21: ifeq 
Reason: 
Expected stackmap frame at this location. 
Bytecode: 
0000000: b200 0212 03b6 0004 b800 05b6 0006 4c2b 
0000010: 1207 b600 0899 0003 b200 0212 09b6 0004 
0000020: a700 Obb2 0002 120a b600 04b1 


Stackmap Table: 


append frame(Q35,0bject[£20]) 
same frame(Q43) 


at 
at 
at 
at 
at 


java.lang.Class.getDeclaredMethodsO(Native Method) 
java.lang.Class.privateGetDeclaredMethods(Class.java:2615) 
java.lang.Class.getMethod0(Class.java:2856) 
java.lang.Class.getMethod(Class.java:1668) 

sun. launcher.LauncherHelper.getMainMethod(LauncherHelper.java7 
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V 1494) 
at sun. launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.javaZ 
V :486) 


But it must be mentioned that it worked in JRE 1.6. 


We can also try to replace to all 3 ifeq opcode bytes with zero bytes (NOP), and it 


still won't work. 


Seems like there are more stack map checks in JRE 1.7. 


OK, we'll replace the whole call to the equals method with the iconst 1 instruction 
plus a pack of NOPs: 


* 78 
* (018 
* 82 


* 184 
* H82 
* (076 


664 
888 
800 
666 
666 
666 
153 


178 
618 
182 
167 


178 


888 
663 
666 


668 
669 
668 
668 


662 


664 


665 
806 


614 


662 


664 
611 
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; Segment type: Pure code 


-method public static main([Ljava/lang/String;)U 
-limit stack 2 

-limit locals 2 

-line 3 


getstatic java/lang/System.out Ljava/io/PrintStream; 
ldc "Please enter the password" 
invokevirtual jaua/io/PrintStream.printin(Ljava/lang/String;)U 
-line 4 
invokestatic java/lang/System.console()Ljava/io/Console; 
invokevirtual jaua/io/Console.readLine()Ljava/lang/String; 
astore 1 ; met882 slot881 
-line 5 
iconst 1 
nop 
nop 
nop 
nop 
nop 
ifeq met882 35 
-line 6 
getstatic java/lang/System.out Ljava/io/PrintStream; 
ldc “password is correct" 
invokevirtual jaua/io/PrintStream.printin(Ljava/lang/String;)U 
goto met882 ^3 
-line 8 
met882 35: ; CODE XREF: main+211j 
-Stack use locals 


locals Object java/lang/String 
.end stack 


Figure 4.6: IDA 


1 needs always to be in the TOS when the ifeq instruction is executed, so ifeq 
would never jump. 


This works. 
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4.1.18 Summary 


What is missing in Java in comparison to C/C++? 
* Structures: use classes. 
* Unions: use class hierarchies. 


* Unsigned data types. By the way, this makes cryptographic algorithms some- 
what harder to implement in Java. 


* Function pointers. 
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Finding important/interesting 
stuff in the code 


Minimalism it is not a prominent feature of modern software. 


But not because the programmers are writing a lot, but because a lot of libraries are 
commonly linked statically to executable files. If all external libraries were shifted 
into an external DLL files, the world would be different. (Another reason for C++ are 
the STL and other template libraries.) 


Thus, it is very important to determine the origin of a function, if it is from standard 
library or well-known library (like Boost!, libpng?), or if it is related to what we are 
trying to find in the code. 


It is just absurd to rewrite all code in C/C++ to find what we're looking for. 


One of the primary tasks of a reverse engineer is to find quickly the code he/she 
needs, and what is not that important. 


The IDA disassembler allow us to search among text strings, byte sequences and 
constants. It is even possible to export the code to .Ist or .asm text files and then 
use grep, awk, etc. 


When you try to understand what some code is doing, this easily could be some open- 
source library like libpng. So when you see some constants or text strings which look 
familiar, it is always worth to google them. And if you find the opensource project 
where they are used, then it's enough just to compare the functions. It may solve 
some part of the problem. 


For example, if a program uses XML files, the first step may be determining which 
XML library is used for processing, since the standard (or well-known) libraries are 
usually used instead of self-made one. 


For example, the author of these lines once tried to understand how the compres- 
sion/decompression of network packets works in SAP 6.0. It is a huge software, but 


lhttp://www.boost.org/ 
2http://www. Libpng.org/pub/png/libpng. html 


888 


889 
a detailed .PDB with debugging information is present, and that is convenient. He 
finally came to the idea that one of the functions, that was called CsDecomprLZC, 
was doing the decompression of network packets. Immediately he tried to google 
its name and he quickly found the function was used in MaxDB (it is an open-source 
SAP project) ?. 


http://www.google.com/search?q-CsDecomprLZC 


Astoundingly, MaxDB and SAP 6.0 software shared likewise code for the compres- 
sion/decompression of network packets. 


5.1 Identification of executable files 


5.1.1 Microsoft Visual C++ 
MSVC versions and DLLs that can be imported: 


Marketing ver. | Internal ver. | CL.EXE ver. | DLLs imported | Release date 

6 6.0 12.00 msvcrt.dll June 1998 
msvcp60.dll 

.NET (2002) 7.0 13.00 msvcr70.dll February 13, 2002 
msvcp70.dll 

.NET 2003 7.1 13.10 msvcr7 1.dll April 24, 2003 
msvcp71.dll 

2005 8.0 14.00 msvcr80.dll November 7, 2005 
msvcp80.dll 

2008 9.0 15.00 msvcr90.dll November 19, 2007 
msvcp90.dll 

2010 10.0 16.00 msvcr100.dll April 12, 2010 
msvcp100.dll 

2012 11.0 17.00 msvcr110.dll September 12, 2012 
msvcp110.dll 

2013 12.0 18.00 msvcr120.dll October 17, 2013 
msvcp120.dll 


msvcp*.dll has C++-related functions, so if it is imported, this is probably a C++ 
program. 
Name mangling 


The names usually start with the ? symbol. 


You can read more about MSVC's name mangling here: 3.21.1 on page 683. 


5.1.2 GCC 


Aside from *NIX targets, GCC is also present in the win32 environment, in the form 
of Cygwin and MinGW. 


3More about it in relevant section (8.12.1 on page 1112) 
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Name mangling 


Names usually start with the Z symbols. 
You can read more about GCC's name mangling here: 3.21.1 on page 683. 


Cygwin 


cygwin1.dll is often imported. 


MinGW 


msvcrt.dll may be imported. 


5.1.3 Intel Fortran 


libifcoremd.dll, libifportmd.dll and libiomp5md.dll (OpenMP support) may be imported. 
libifcoremd.dll has a lot of functions prefixed with for , which means Fortran. 


5.1.4 Watcom, OpenWatcom 
Name mangling 


Names usually start with the W symbol. 


For example, that is how the method named "method" of the class "class" that does 
not have any arguments and returns void is encoded: 


W?method$ class$n v 


5.1.5 Borland 


Here is an example of Borland Delphi's and C++Builder’s name mangling: 


@TApplication@IdleAction$qv 
@TApplication@ProcessMDIAccels$qp6tagMSG 
@TModule@$bctr$qpcpvt1l 

@TModule@$bdt r$qv 
@TModule@ValidWindow$qp14TWindowsObject 


GTrueBitmape$bctr$qpcl 
GTrueBitmape$bctr$qpvl 
@TrueBitmap@$bctr$qiilll 


The names always start with the @ symbol, then we have the class name came, 
method name, and encoded the types of the arguments of the method. 


These names can be in the .exe imports, .dll exports, debug data, etc. 
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Borland Visual Component Libraries (VCL) are stored in .bpl files instead of .dll ones, 
for example, vcl50.dll, rtl60.dll. 


Another DLL that might be imported: BORLNDMM.DLL. 


Delphi 


Almost all Delphi executables has the "Boolean" text string at the beginning of the 
code segment, along with other type names. 


This is a very typical beginning of the CODE segment of a Delphi program, this block 
came right after the win32 PE file header: 


04 10 40 00 03 07 42 6f 6f 6c 65 61 6e 01 00 00 |..@...Boolean... | 
00 00 01 00 00 00 00 10 40 00 05 46 61 6c 73 65  |........ Q..False| 
04 54 72 75 65 8d 40 00 2c 10 40 00 09 08 57 69 |.True.@.,.@...Wi| 
64 65 43 68 61 72 03 00 00 00 00 ff ff 00 00 90 |deChar.......... | 
44 10 40 00 02 04 43 68 61 72 01 00 00 00 00 ff |D.@...Char...... | 


00 00 00 90 58 10 40 00 01 08 53 6d 61 6c 6c 69 |....X.Q...Smalli| 
6e 74 02 00 80 ff ff ff 7f 00 00 90 70 10 40 00 |nt.......... p.@. | 
01 07 49 6e 74 65 67 65 72 04 00 00 00 80 ff ff |..Integer....... | 
ff 7f 8b cO 88 10 40 00 01 04 42 79 74 65 01 00 |...... Q...Byte..| 
00 00 00 ff 00 00 00 90 9c 10 40 00 01 04 57 6f |.......... Q. ..Wo | 
72 64 03 00 00 00 00 ff ff 00 00 90 bO 10 40 00 |rd............ Q. | 
01 08 43 61 72 64 69 6e 61 6c 05 00 00 00 00 ff |..Cardinal...... | 
ff ff ff 90 c8 10 40 00 10 05 49 Ge 74 36 34 00 |...... Q...Int64.| 
00 00 00 00 00 00 80 ff ff ff ff ff ff ff 7f 90 ]................ 
e4 10 40 00 04 08 45 78 74 65 6e 64 65 64 02 90 ..@...Extended.. 
f4 10 40 00 04 06 44 6f 75 62 6c 65 01 8d 40 00 ..@...Double..@. 
04 11 40 00 04 08 43 75 72 72 65 6e 63 79 04 90 Q...Currency.. 


. WideString0.G. 
..Variant.@.@.@. 


| | 
| | 
14 11 40 00 0a 06 73 74 72 69 6e 67 20 11 40 00 |..@...string .@. | 
| | 
| | 
|..OleVariant..@. | 


28 4d 40 00 2c 4d 40 00 20 4d 40 00 68 4a 40 00 |(M@.,M@. MG. hJe. 


84 4a 40 00 cO 4a 40 00 07 54 4f 62 6a 65 63 74 |.Ja..Ja..TObject| 
a4 11 40 00 07 07 54 4f 62 6a 65 63 74 98 11 40 |..@...TObject. .@| 
00 00 00 00 00 00 00 06 53 79 73 74 65 6d 00 00 |........ System.. | 
c4 11 40 00 Of Oa 49 49 Ge 74 65 72 66 61 63 65 |..@...IInterface| 
00 00 00 00 01 00 00 00 00 00 00 00 00 cO 00 00 J]................ 
00 00 00 00 46 06 53 79 73 74 65 6d 03 00 ff ff ..F.System....| 
f4 11 40 00 Of 09 49 44 69 73 70 61 74 63 68 c0 ..@...IDispatch. | 


| 

E | 
00 00 00 46 06 53 79 73 74 65 6d 04 00 ff ff 90 |...F. 25 T" | 

E 

| 


cc 83 44 24 04 f8 e9 51 6c 00 00 83 44 24 04 f8 D$.. .D$..| 
e9 6f 6c 00 00 83 44 24 04 f8 e9 79 6c 00 00 cc .ol oe 
cc 21 12 40 00 2b 12 40 00 35 12 40 00 01 00 00 .1.0.+.0.5.0....] 
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bc 12 40 00 Oc 00 00 00 4c 11 40 00 18 4d 40 00 |..@..... L.@. .M@. 
50 7e 40 00 5c 7e 40 00 2c 4d 40 00 20 4d 40 00 |P~@.\~@.,M@. Me. 
6c 7e 40 00 84 4a 40 00 cO 4a 40 00 11 54 49 6e |1~@..J@..jJ@..TIn 
74 65 72 66 61 63 65 64 4f 62 6a 65 63 74 8b cO |terfacedObject.. 


d4 12 40 00 07 11 54 49 6e 74 65 72 66 61 63 65 |..@. s 
00 06 53 79 73 74 65 6d 00 00 8b cO 00 13 40 00 |..System...... 
11 Ob 54 42 6f 75 6e 64 41 72 72 61 79 04 00 00 |..TBoundArray.. 
00 00 00 00 00 03 00 00 00 6c 10 40 00 06 53 79  |......... n .Sy 


73 74 65 6d 28 13 40 00 04 09 54 44 61 74 65 54 |stem(.@. abies 


| 
| 
| 
a 
64 4f 62 6a 65 63 74 bc 12 40 00 a0 11 40 00 00 |dObject..@...@.. | 
e. | 
| 
er 
69 6d 65 01 ff 25 48 e0 c4 00 8b cO ff 25 44 eO |ime..%H...... D.| 


The first 4 bytes of the data segment (DATA) can be 00 00 00 00, 32 13 8B C0 or 
FF FF FF FF. 


This information can be useful when dealing with packed/encrypted Delphi executa- 
bles. 


5.1.6 Other known DLLs 


e vcomp*.dll—Microsoft's implementation of OpenMP. 


5.2 Communication with outer world (function level) 


It's often advisable to track function arguments and return values in debugger or DBI. 
For example, the author once tried to understand meaning of some obscure function, 
which happens to be incorrectly implemented bubble sort^. (It worked correctly, but 
slower.) Meanwhile, watching inputs and outputs of this function helps instantly to 
understand what it does. 


Often, when you see division by multiplication (3.12 on page 621), but forgot all 
details about its mechanics, you can just observe input and output and quickly find 
divisor. 


5.3 Communication with the outer world (win32) 
Sometimes it's enough to observe some function's inputs and outputs in order to 
understand what it does. That way you can save time. 


Files and registry access: for the very basic analysis, Process Monitor? utility from 
Sysinternals can help. 


For the basic analysis of network accesses, Wireshark® can be useful. 


But then you will have to look inside anyway. 


^https://yurichev.com/blog/weird sort KLEE/ 
5http://technet.microsoft.com/en-us/sysinternals/bb896645.aspx 
Shttp://www.wireshark.org/ 
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The first thing to look for is which functions from the OS's APIs and standard libraries 
are used. 


If the program is divided into a main executable file and a group of DLL files, some- 
times the names of the functions in these DLLs can help. 


If we are interested in exactly what can lead to a call to MessageBox() with specific 
text, we can try to find this text in the data segment, find the references to it and 
find the points from which the control may be passed to the MessageBox() call we're 
interested in. 


If we are talking about a video game and we're interested in which events are more 
or less random in it, we may try to find the rand() function or its replacements 
(like the Mersenne twister algorithm) and find the places from which those functions 
are called, and more importantly, how are the results used. One example: 8.3 on 
page 1018. 


But if it is not a game, and rand() is still used, it is also interesting to know why. 
There are cases of unexpected rand() usage in data compression algorithms (for 
encryption imitation): blog.yurichev.com. 


5.3.1 Often used functions in the Windows API 


These functions may be among the imported. It is worth to note that not every 
function might be used in the code that was written by the programmer. A lot of 
functions might be called from library functions and CRT code. 


Some functions may have the -A suffix for the ASCII version and -W for the Unicode 
version. 


Registry access (advapi32.dll): RegEnumKeyEx, RegEnumValue, RegGetValue, 
RegOpenKeyEx, RegQueryValueEx. 


Access to text .ini-files (kernel32.dll): GetPrivateProfileString. 


Dialog boxes (user32.dll); MessageBox, MessageBoxEx, CreateDialog, SetDI- 
gltemText, GetDlgltemText. 


Resources access (6.5.2 on page 971): (user32.dll): LoadMenu. 

TCP/IP networking (ws2 32.dll); WSARecv, WSASend. 

File access (kernel32.dll): CreateFile, ReadFile, ReadFileEx, WriteFile, WriteFileEx. 
High-level access to the Internet (wininet.dll): WinHttpOpen. 


Checking the digital signature of an executable file (wintrust.dll): WinVerifyTrust. 


The standard MSVC library (if it’s linked dynamically) (msvcr*.dll): assert, itoa, 
Itoa, open, printf, read, strcmp, atol, atoi, fopen, fread, fwrite, memcmp, rand, 
strlen, strstr, strchr. 
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5.3.2 Extending trial period 


Registry access functions are frequent targets for those who try to crack trial period 
of some software, which may save installation date/time into registry. 


Another popular target are GetLocalTime() and GetSystemTime() functions: a trial 
software, at each startup, must check current date/time somehow anyway. 


5.3.3 Removing nag dialog box 
A popular way to find out what causing popping nag dialog box is intercepting Mes- 
sageBox(), CreateDialog() and CreateWindow() functions. 


5.3.4 tracer: Intercepting all functions in specific module 


There are INT3 breakpoints in the tracer, that are triggered only once, however, they 
can be set for all functions in a specific DLL. 


--one-time-INT3-bp:somedll.dll!.* 


Or, let's set INT3 breakpoints on all functions with the xml prefix in their name: 


--one-time-INT3-bp:somedll.dll!xml.* 


On the other side of the coin, such breakpoints are triggered only once. Tracer will 
show the call of a function, if it happens, but only once. Another drawback—it is 
impossible to see the function's arguments. 


Nevertheless, this feature is very useful when you know that the program uses a 
DLL, but you do not know which functions are actually used. And there are a lot of 
functions. 


For example, let's see, what does the uptime utility from cygwin use: 


tracer -l:uptime.exe --one-time-INT3-bp:cygwinl.dll!.* 


Thus we may see all that cygwin1.dll library functions that were called at least once, 
and where from: 


One-time INT3 breakpoint: cygwinl.dll! main (called from uptime.exe!OEP-«07 
V x6d (0x40106d)) 

One-time INT3 breakpoint: cygwinl.dll! geteuid32 (called from uptime.exe! / 
S OEP+0xba3 (0x401ba3)) 

One-time INT3 breakpoint: cygwinl.dll! getuid32 (called from uptime.exe!OEP7 
V +0xbaa (0x401baa)) 

One-time INT3 breakpoint: cygwinl.dll! getegid32 (called from uptime.exe! ? 
S OEP+0xcb7 (0x401cb7)) 

One-time INT3 breakpoint: cygwinl.dll! getgid32 (called from uptime.exe!OEP7 
V +0xcbe (0x401cbe)) 

One-time INT3 breakpoint: cygwinl.dll!sysconf (called from uptime. exe! 0EP+0/ 
V x735 (0x401735) ) 

One-time INT3 breakpoint: cygwinl.dll!setlocale (called from uptime.exe!OEP7 
S +0x7b2 (0x4017b2)) 
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One-time INT3 breakpoint: cygwinl.dll! open64 (called from uptime. exe! O0EP+0/ 
S x994 (0x401994)) 

One-time INT3 breakpoint: cygwinl.dll! lseek64 (called from uptime.exe!OEP7 
V +0x7ea (0x4017ea)) 

One-time INT3 breakpoint: cygwinl.dll!read (called from uptime.exe!0EP+0 ? 
S x809 (0x401809)) 

One-time INT3 breakpoint: cygwinl.dll!sscanf (called from uptime.exe!OEP-«07 
S x839 (0x401839)) 

One-time INT3 breakpoint: cygwinl.dll!uname (called from uptime.exe!0EP+0 
S x139 (0x401139)) 

One-time INT3 breakpoint: cygwinl.dll!time (called from uptime.exe!OEP-«07 
V x22e (0x40122e) ) 

One-time INT3 breakpoint: cygwinl.dll!localtime (called from uptime.exe!OEP7 
V +0x236 (0x401236)) 

One-time INT3 breakpoint: cygwinl.dll!sprintf (called from uptime. exe! 0EP+0/ 
y x25a (0x40125a)) 

One-time INT3 breakpoint: cygwinl.dll!setutent (called from uptime.exe!OEP7 
S +0x3b1 (0x4013b1)) 

One-time INT3 breakpoint: cygwinl.dll!getutent (called from uptime.exe!OEP7 
V +0x3c5 (0x4013c5)) 

One-time INT3 breakpoint: cygwinl.dll!endutent (called from uptime.exe!OEP7 
V +0x3e6 (0x4013e6)) 

One-time INT3 breakpoint: cygwinl.dll!puts (called from uptime.exe!0EP+0/ 
V X4c3 (0x4014c3)) 


5.4 Strings 


5.4.1 Text strings 
C/C++ 


The normal C strings are zero-terminated (ASCIIZ-strings). 


The reason why the C string format is as it is (zero-terminated) is apparently histor- 
ical. In [Dennis M. Ritchie, The Evolution of the Unix Time-sharing System, (1979)] 
we read: 


A minor difference was that the unit of I/O was the word, not the 
byte, because the PDP-7 was a word-addressed machine. In practice 
this meant merely that all programs dealing with character streams 
ignored null characters, because null was used to pad a file to an even 
number of characters. 


In Hiew or FAR Manager these strings look like this: 


int main() 


{ 
i 


printf ("Hello, world!\n"); 
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Figure 5.1: Hiew 


Borland Delphi 
The string in Pascal and Borland Delphi is preceded by an 8-bit or 32-bit string length. 


For example: 


Listing 5.1: Delphi 


CODE :00518AC8 dd 19h 

CODE:00518ACC aLoading Plea db 'Loading... , please wait.',0 
CODE :00518AFC dd 10h 

CODE:00518B00 aPreparingRun db 'Preparing run...',0 
Unicode 


Often, what is called Unicode is a methods for encoding strings where each character 
occupies 2 bytes or 16 bits. This is a common terminological mistake. Unicode is a 
standard for assigning a number to each character in the many writing systems of 
the world, but does not describe the encoding method. 


The most popular encoding methods are: UTF-8 (is widespread in Internet and *NIX 
systems) and UTF-16LE (is used in Windows). 


UTF-8 


UTF-8 is one of the most successful methods for encoding characters. All Latin sym- 
bols are encoded just like in ASCII, and the symbols beyond the ASCII table are en- 
coded using several bytes. 0 is encoded as before, so all standard C string functions 
work with UTF-8 strings just like any other string. 
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Let's see how the symbols in various languages are encoded in UTF-8 and how it 
looks like in FAR, using the 437 codepage’: 


How much? 100€? 


(English) I can eat glass and it doesn't hurt me. 

(Greek) Mnop® va pam cnacuéva yuaAlad xwopic va náSw tinota. 
(Hungarian) Meg tudom enni az üveget, nem lesz tóle bajom. 
(Icelandic) Eg get etió gler án bess að meiða mig. 
(Polish) Mogę jeść szkło i mi nie szkodzi. 

(Russian) A mory ecTb CTeKJIO, OHO MHe He BpenurT. 

(Arabic): ,ia1$5 Y lia 9 gLj JSÍ tc yola Lil. 
(Hebrew): ^? j^rn £% ATI n^2127T 21387? 2137 "IN. 

(Chinese) KRG TRIMER ° 

(Japanese) HITA BONES) ENAERE DIECA? 

(Hindi) # sia @ Bea g HR AM sas HS uie al wgudr. 


Figure 5.2: FAR: UTF-8 


As you can see, the English language string looks the same as it is in ASCII. 
The Hungarian language uses some Latin symbols plus symbols with diacritic marks. 


These symbols are encoded using several bytes, these are underscored with red. It’s 
the same story with the Icelandic and Polish languages. 


There is also the “Euro” currency symbol at the start, which is encoded with 3 bytes. 
The rest of the writing systems here have no connection with Latin. 


At least in Russian, Arabic, Hebrew and Hindi we can see some recurring bytes, and 
that is not surprise: all symbols from a writing system are usually located in the 
same Unicode table, so their code begins with the same numbers. 


At the beginning, before the “How much?” string we see 3 bytes, which are in fact 
the BOM?. The BOM defines the encoding system to be used. 


7The example and translations was taken from here: http://www. columbia. edu/~fdc/utf8/ 
8Byte Order Mark 
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UTF-16LE 


Many win32 functions in Windows have the suffixes -A and -W. The first type of 
functions works with normal strings, the other with UTF-16LE strings (wide). 


In the second case, each symbol is usually stored in a 16-bit value of type short. 


The Latin symbols in UTF-16 strings look in Hiew or FAR like they are interleaved with 
zero byte: 


int wmain() 


1 
$; 


wprintf (L"Hello, world!\n"); 


Figure 5.3: Hiew 


We can see this often in Windows NT system files: 


view ntoskrnl.exe - Far 2.0.1807 x64 Administrator 


Figure 5.4: Hiew 
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Strings with characters that occupy exactly 2 bytes are called "Unicode" in IDA: 


.data:0040E000 aHelloWorld: 
.data:0040E000 unicode 0, «Hello, world!» 
.data:0040E000 dw 0Ah, 0 


Here is how the Russian language string is encoded in UTF-16LE: 


|. AAA =10/x] 


Figure 5.5: Hiew: UTF-16LE 


What we can easily spot is thatthe symbols are interleaved by the diamond character 
(which has the ASCII code of 4). Indeed, the Cyrillic symbols are located in the 
fourth Unicode plane. Hence, all Cyrillic symbols in UTF-16LE are located in the 
0x400-0x4FF range. 


Let's go back to the example with the string written in multiple languages. Here is 
how it looks like in UTF-16LE. 
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Figure 5.6: FAR: UTF-16LE 


Here we can also see the BOM at the beginning. All Latin characters are interleaved 
with a zero byte. 


Some characters with diacritic marks (Hungarian and Icelandic languages) are also 
underscored in red. 


Base64 


The base64 encoding is highly popular forthe cases when you have to transfer binary 
data as a text string. 


In essence, this algorithm encodes 3 binary bytes into 4 printable characters: all 26 
Latin letters (both lower and upper case), digits, plus sign (“+”) and slash sign ("/"), 
64 characters in total. 


One distinctive feature of base64 strings is that they often (but not always) end with 
1 or 2 padding equality symbol(s) (“=”), for example: 


AVjbbVSVf cUMu1xvj aMgj NtueRwBbxnyJw8dpGnLW8ZW8aKG3v4YOicuQT-*qEJAp9lAO0uWs- 


WV jbbVSVf cUMu1xvj aMgj NtueRwBbxnyJw8dpGnLW8ZW8akG3v4Y0icuQT+qEJAp9 LAOUQ== 


The equality sign (“=”) is never encounter in the middle of base64-encoded strings. 


Now example of manual encoding. Let's encode 0x00, 0x11, 0x22, 0x33 hexadeci- 
mal bytes into base64 string: 
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$ echo -n "Xx00Nx11Nx22Nx33" | base64 
ABEiMw-- 


Let's put all 4 bytes in binary form, then regroup them into 6-bit groups: 


00 || 11 || 22 || 33 
00000000000100010010001000110011???????????????? 
IA IIB [|E ||i |[M_|]w |= 11 | 


Three first bytes (0x00, 0x11, 0x22) can be encoded into 4 base64 characters ("ABEi"), 
but the last one (0x33) — cannot be, so it's encoded using two characters ("Mw") and 
padding symbol (“=”) is added twice to pad the last group to 4 characters. Hence, 
length of all correct base64 strings are always divisible by 4. 


Base64 is often used when binary data needs to be stored in XML. "Armored" (i.e., 
in text form) PGP keys and signatures are encoded using base64. 


Some people tries to use base64 to obfuscate strings: http://blog.sec-consult. 
com/2016/01/deliberately-hidden-backdoor-account-in.html °. 


There are utilities for scanning an arbitrary binary files for base64 strings. One such 
utility is base64scanner?, 


Another encoding system which was much more popular in UseNet and FidoNet is 
Uuencoding. Binary files are still encoded in Uuencode format in Phrack magazine. 
It offers mostly the same features, but is different from base64 in the sense that file 
name is also stored in header. 


By the way: there is also close sibling to base64: base32, alphabet of which has 10 
digits and 26 Latin characters. One well-known usage of it is onion addresses ??, 
like: 

http://3g2upl4pq6kufc4m.onion/. URL can't have mixed-case Latin characters, 
so apparently, this is why Tor developers used base32. 


5.4.2 Finding strings in binary 


Actually, the best form of Unix 
documentation is frequently running the 
strings command over a program's object 
code. Using strings, you can get a complete 
list of the program's hard-coded file name, 
environment variables, undocumented 
options, obscure error messages, and so 
forth. 


The Unix-Haters Handbook 


The standard UNIX strings utility is quick-n-dirty way to see strings in file. For exam- 
ple, these are some strings from OpenSSH 7.2 sshd executable file: 


9http://archive.is/nDCas 
l0https://github.com/DennisYurichev/base64scanner 
Mhttps://trac.torproject.org/projects/tor/wiki/doc/HiddenServiceNames 
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0123 

0123456789 
0123456789abcdefABCDEF. :/ 
%02x 


.100s, line %lu: Bad permitopen specification <%.100s> 
.100s, line %lu: invalid criteria 
.100s, line %lu: invalid tun device 


oe ge ge - 


.200s/.ssh/environment 


oe: 


2886173b9c9b6 fdbdeda7a247cd636db38deaa. debug 
$2a$06$r3. j UUaHZDLIbQa02dS9FuYXL1W9M81R1T c92POSNmzvpEqLkLGrk 


3des-cbc 

Bind to port %s on %s. 
Bind to port %s on %s failed: %.200s. 
/bin/login 

/bin/sh 

/bin/sh /etc/ssh/sshrc 
D$4PQWR1 

D$4PUj 

D$4PV 

D$4PVj 

D$4PW 

D$4PWj 

D$4X 

D$4XZj 

D$4Y 


diffie-hellman-group-exchange-shal 
diffie-hellman-group-exchange-sha256 
digests 

D$iPV 

direct-streamlocal 
direct-streamlocal@openssh. com 


FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A6. . . 


There are options, error messages, file paths, imported dynamic modules and func- 
tions, some other strange strings (keys?) There is also unreadable noise—x86 code 
sometimes has chunks consisting of printable ASCII characters, up to 8 characters. 


Of course, OpenSSH is open-source program. But looking at readable strings inside 
of some unknown binary is often a first step of analysis. 


grep can be applied as well. 
Hiew has the same capability (Alt-F6), as well as Sysinternals ProcessMonitor. 
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5.4.3 Error/debug messages 


Debugging messages are very helpful if present. In some sense, the debugging 
messages are reporting what's going on in the program right now. Often these are 
printf()-like functions, which write to log-files, or sometimes do not writing any- 
thing but the calls are still present since the build is not a debug one but release one. 


If local or global variables are dumped in debug messages, it might be helpful as 
well since it is possible to get at least the variable names. For example, one of such 
function in Oracle RDBMS is ksdwrt(). 


Meaningful text strings are often helpful. The IDA disassembler may show from which 
function and from which point this specific string is used. Funny cases sometimes 
happen??. 


The error messages may help us as well. In Oracle RDBMS, errors are reported using 
a group of functions. 
You can read more about them here: blog.yurichev.com. 


It is possible to find quickly which functions report errors and in which conditions. 


By the way, this is often the reason why copy-protection systems use inarticulate 
cryptic error messages or just error numbers. No software author is happy if the 
software cracker can quickly understands copy-protection’s inner workings judging 
by error messages it can produce. 


One example of encrypted error messages is here: 8.8.2 on page 1065. 


5.4.4 Suspicious magic strings 
Some magic strings which are usually used in backdoors look pretty suspicious. 


For example, there was a backdoor in the TP-Link WR740 home router. The back- 
door can activated using the following URL: 
http://192.168.0.1/userRpmNatDebugRpm26525557/start_art.html. 


Indeed, the "userRpmNatDebugRpm26525557" string is present in the firmware. 


This string was not googleable until the wide disclosure of information about the 
backdoor. 


You would not find this in any RFC*, 


You would not find any computer science algorithm which uses such strange byte 
sequences. 


And it doesn't look like an error or debugging message. 


12blog.yurichev.com 
13http://sekurak.pl/tp-link-httptftp-backdoor/ 
Request for Comments 
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So it's a good idea to inspect the usage of such weird strings. 


Sometimes, such strings are encoded using base64. 
So it's a good idea to decode them all and to scan them visually, even a glance 
should be enough. 


More precise, this method of hiding backdoors is called "security through obscu- 
rity". 


5.5 Calls to assert() 


Sometimes the presence of the assert () macro is useful too: commonly this macro 
leaves source file name, line number and condition in the code. 


The most useful information is contained in the assert's condition, we can deduce 
variable names or structure field names from it. Another useful piece of information 
are the file names—we can try to deduce what type of code is there. Also it is possible 
to recognize well-known open-source libraries by the file names. 


Listing 5.2: Example of informative assert() calls 


.text:107D4B29 mov dx, [ecx+42h] 

.text:107D4B2D cmp edx, 1 

.text:107D4B30 jz short loc 107D4B4A 

.text:107D4B32 push 1ECh 

.text:107D4B37 push offset aWrite c ; "write.c" 

.text:107D4B3C push offset aTdTd planarcon ; 
"td->td planarconfig == PLANARCONFIG CON"... 

.text:107D4B41 call ds: assert 


.text:107D52CA mov edx, [ebp-4] 

.text:107D52CD and edx, 3 

.text:107D52D0 test edx, edx 

.text:107D52D2 jz short loc 107D52bE9 

.text:107D52D4 push 58h 

.text:107D52D6 push offset aDumpmode c ; "dumpmode.c" 
.text:107D52DB push offset aN30 ; "(n & 3) == 0" 
.text:107D52E0 call ds: assert 


.text:107D6759 mov cx, [eax+6] 

.text:107D675D cmp ecx, OCh 

.text:107D6760 jle short loc 107D677A 

.text:107D6762 push 2D8h 

.text:107D6767 push offset aLzw c >; "lzw.c" 

.text:107D676C push offset aSpLzw nbitsBit ; “sp->lzw_nbits <= BITS MAX" 
.text:107D6771 call ds: assert 
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It is advisable to "google" both the conditions and file names, which can lead us to 
an open-source library. For example, if we "google" “sp->Izw_nbits <= BITS MAX", 
this predictably gives us some open-source code that's related to the LZW compres- 
sion. 


5.6 Constants 


Humans, including programmers, often use round numbers like 10, 100, 1000, in 
real life as well as in the code. 


The practicing reverse engineer usually know them well in hexadecimal representa- 
tion: 10=0xA, 100=0x64, 1000=0x3E8, 10000=0x2710. 


The constants OxAAAAAAAA (0b10101010101010101010101010101010) and 
0x55555555 (0b01010101010101010101010101010101) are also popular—those are 
composed of alternating bits. 


That may help to distinguish some signal from a signal where all bits are turned on 
(0b1111 ...) or off (0b0000 ...). For example, the 0x55AA constant is used at least in 
the boot sector, MBR?^, and in the ROM of IBM-compatible extension cards. 


Some algorithms, especially cryptographical ones use distinct constants, which are 
easy to find in code using IDA. 


For example, the MD5 algorithm initializes its own internal variables like this: 


var int hO := 0x67452301 
var int hl := OxEFCDAB89 
var int h2 := 0x98BADCFE 
var int h3 := 0x10325476 


If you find these four constants used in the code in a row, it is highly probable that 
this function is related to MD5. 


Another example are the CRC16/CRC32 algorithms, whose calculation algorithms 
often use precomputed tables like this one: 


Listing 5.3: linux/lib/crc16.c 


/** CRC table for the CRC-16. The poly is 0x8005 (x^l6 + x^15 + x^2 + 1) */ 
ul6 const crcl6 table[256] = { 
0x0000, OxCOC1, OxC181, 0x0140, 0xC301, 0x03CO, 0x0280, 0xC241, 
0xC601, 0x06CO, 0x0780, OxC741, 0x0500, OxC5C1, 0xC481, 0x0440, 
OxCCO1, OxOCCO, OxOD80, OxCD41, OxOFOO, OXCFC1, OxCE81, 0x0E40, 


See also the precomputed table for CRC32: 3.8 on page 601. 


In tableless CRC algorithms well-known polynomials are used, for example, OXEDB88320 
for CRC32. 


15Master Boot Record 
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5.6.1 Magic numbers 


A lot of file formats define a standard file header where a magic number(s) is used, 
single one or even several. 


For example, all Win32 and MS-DOS executables start with the two characters "MZ". 


At the beginning of a MIDI file the "MThd" signature must be present. If we have a 
program which uses MIDI files for something, it's very likely that it must check the 
file for validity by checking at least the first 4 bytes. 


This could be done like this: (buf points to the beginning ofthe loaded file in memory) 


cmp [buf], 0x6468544D ; "MThd" 
jnz error not a MIDI file 


...Or by calling a function for comparing memory blocks like memcmp () or any other 
equivalent code up to a CMPSB (.1.6 on page 1304) instruction. 


When you find such point you already can say where the loading of the MIDI file 
starts, also, we could see the location of the buffer with the contents of the MIDI file, 
what is used from the buffer, and how. 


Dates 


Often, one may encounter number like 0x19870116, which is clearly looks like a date 
(year 1987, 1th month (January), 16th day). This may be someone's birthday date 
(a programmer, his/her relative, child), or some other important date. The date may 
also be written in a reverse order, like 0x16011987. American-style dates are also 
popular, like 0x01161987. 


Well-known example is 0x19540119 (magic number used in UFS2 superblock struc- 
ture), which is a birthday date of Marshall Kirk McKusick, prominent FreeBSD contrib- 
utor. 


Stuxnet uses the number “19790509” (not as 32-bit number, but as string, though), 
and this led to speculation that the malware is connected to Israel?®. 


Also, numbers like those are very popular in amateur-grade cryptography, for exam- 
ple, excerpt from the secret function internals from HASP3 dongle 17: 


void xor pwd(void) 


1 
int i; 
pwd*=0x09071966; 
for (i=0;i<8;i++) 
{ 
al_buf[il= pwd € 7; pwd = pwd >> 3; 
} 
h 


16This is a date of execution of Habib Elghanian, persian jew. 
Vhttps://web.archive.org/web/20160311231616/http: //www.woodmann. com/fravia/bayu3.htm 
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void emulate func2(unsigned short seed) 
1 
int i, j; 
for(i=0;i<8;i++) 
{ 
ch[i] = 0; 
for (j=0;j<8; j++) 
{ 
seed *= 0x1989; 
seed += 5; 
ch[i] |= (tab[(seed>>9)&Ox3f]) << (7-j); 
} 
} 
} 
DHCP 


This applies to network protocols as well. For example, the DHCP protocol's network 
packets contains the so-called magic cookie: 0x63538263. Any code that generates 
DHCP packets somewhere must embed this constant into the packet. If we find it in 
the code we may find where this happens and, not only that. Any program which can 
receive DHCP packet must verify the magic cookie, comparing it with the constant. 


For example, let's take the dhcpcore.dll file from Windows 7 x64 and search for 
the constant. And we can find it, twice: it seems that the constant is used in two 
functions with descriptive names 

DhcpExtractOptionsForValidation() and DhcpExtractFullOptions(): 


Listing 5.4: dhcpcore.dll (Windows 7 x64) 


| . rdata :000007FF6483CBE8 dword 7FF6483CBE8 dd 63538263h ; DATA XREF: | 
DhcpExtractO0ptionsForValidation+79 
| .rdata:000007FF6483CBEC dword 7FF6483CBEC dd 63538263h ; DATA XREF: | 


DhcpExtractFullOptions-97 


And here are the places where these constants are accessed: 


Listing 5.5: dhcpcore.dll (Windows 7 x64) 


.text:000007FF6480875F mov eax, [rsi] 
.text:000007FF64808761 cmp eax, cs:dword 7FF6483CBE8 
.text:000007FF64808767  jnz loc 7FF64817179 

And: 

Listing 5.6: dhcpcore.dll (Windows 7 x64) 
.text:000007FF648082C7 mov eax, [r12] 
.text:000007FF648082CB  cmp eax, cs:dword 7FF6483CBEC 
.text:000007FF648082D1 jnz loc 7FF648173AF 
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5.6.2 Specific constants 


Sometimes, there is a specific constant for some type of code. For example, the 
author once dug into a code, where number 12 was encountered suspiciously often. 
Size of many arrays is 12, or multiple of 12 (24, etc). As it turned out, that code 
takes 12-channel audio file at input and process it. 


And vice versa: for example, if a program works with text field which has length of 
120 bytes, there has to be a constant 120 or 119 somewhere in the code. If UTF-16 
is used, then 2-120. If a code works with network packets of fixed size, it’s good idea 
to search for this constant in the code as well. 


This is also true for amateur cryptography (license keys, etc). If encrypted block has 
size of n bytes, you may want to try to find occurrences of this number throughout 
the code. Also, if you see a piece of code which is been repeated n times in loop 
during execution, this may be encryption/decryption routine. 


5.6.3 Searching for constants 


It is easy in IDA: Alt-B or Alt-I. And for searching for a constant in a big pile of files, 
or for searching in non-executable files, there is a small utility called binary grep!?. 


5.7 Finding the right instructions 


If the program is utilizing FPU instructions and there are very few of them in the code, 
one can try to check each one manually with a debugger. 


For example, we may be interested how Microsoft Excel calculates the formulae 
entered by user. For example, the division operation. 


If we load excel.exe (from Office 2010) version 14.0.4756.1000 into IDA, make a full 
listing and to find every FDIV instruction (except the ones which use constants as a 
second operand—obviously, they do not suit us): 


cat EXCEL.lst | grep fdiv | grep -v dbl > EXCEL.fdiv 


...then we see that there are 144 of them. 
We can enter a string like 2(1/3) in Excel and check each instruction. 


By checking each instruction in a debugger or tracer (one may check 4 instruction 
at a time), we get lucky and the sought-for instruction is just the 14th: 


.text:3011E919 DC 33 fdiv qword ptr [ebx] 


PID-13944|TID-28744|(0) 0x2f64e919 (Excel.exe!BASE+0x11e919) 
EAX-0x02088006 EBX-0x02088018 ECX-0x00000001 EDX-0x00000001 
ESI-0x02088000 EDI-0x00544804 EBP=0x0274FA3C ESP=0x0274F9F8 
EIP=0x2F64E919 

FLAGS=PF IF 


18GitHub 
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FPU ControlWord-IC RC=NEAR PC=64bits PM UM OM ZM DM IM 
FPU StatusWord= 
FPU ST(0): 1.000000 


ST(0) holds the first argument (1) and second one is in [EBX]. 


The instruction after FDIV (FSTP) writes the result in memory: 


.text:3011E91B DD 1E fstp qword ptr [esi] 


If we set a breakpoint on it, we can see the result: 


PID=32852 | TID=36488|(0) 0x2f40e91b (Excel.exe!BASE+0x11e91b) 
EAX=0x00598006 EBX=0x00598018 ECX=0x00000001 EDX=0x00000001 
EST=0x00598000 EDI=0x00294804 EBP=0x026CF93C ESP=0x026CF8F8 
EIP=0x2F40E91B 

FLAGS=PF IF 

FPU ControlWord=IC RC=NEAR PC=64bits PM UM OM ZM DM IM 

FPU StatusWord=C1 P 

FPU ST(0): 0.333333 


Also as a practical joke, we can modify it on the fly: 


tracer -l:excel.exe bpx=excel.exe!BASE+0x11E91B,set(st0,666) 


PID=36540 | TID=24056|(0) Ox2f40e91b (Excel.exe!BASE+0x11e91b) 
EAX=0x00680006 EBX=0x00680018 ECX=0x00000001 EDX=0x00000001 
ESI=0x00680000 EDI=0x00395404 EBP=0x0290FD9C ESP=0x0290FD58 
EIP=0x2F40E91B 

FLAGS=PF IF 

FPU ControlWord=IC RC=NEAR PC=64bits PM UM OM ZM DM IM 

FPU StatusWord=C1 P 

FPU ST(0): 0.333333 

Set STO register to 666.000000 


Excel shows 666 in the cell, finally convincing us that we have found the right point. 
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Figure 5.7: The practical joke worked 


If we try the same Excel version, but in x64, we will find only 12 FDIV instructions 
there, and the one we looking for is the third one. 


tracer.exe -l:excel.exe bpx=excel.exe!BASE+0x1B7FCC, set (st0,666) 


It seems that a lot of division operations of float and double types, were replaced by 
the compiler with SSE instructions like DIVSD (DIVSD is present 268 times in total). 


5.8 Suspicious code patterns 


5.8.1 XOR instructions 


Instructions like XOR op, op (for example, XOR EAX, EAX) are usually used for set- 
ting the register value to zero, but if the operands are different, the "exclusive or" 
operation is executed. 

This operation is rare in common programming, but widespread in cryptography, 
including amateur one. It's especially suspicious if the second operand is a big num- 
ber. 


This may point to encrypting/decrypting, checksum computing, etc. 


One exception to this observation worth noting is the "canary" (1.26.3 on page 348). 
Its generation and checking are often done using the XOR instruction. 


This AWK script can be used for processing IDA listing (.Ist) files: 


gawk -e '$2=="xor" ( tmp=substr($3, 0, length($3)-1); if (tmp!=$4) if($4!="v 
V esp") if ($4!="ebp") { print $1, $2, tmp, ",", $4 } }' filename.lst 
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It is also worth noting that this kind of script can also match incorrectly disassembled 
code (5.11.1 on page 924). 


5.8.2 Hand-written assembly code 


Modern compilers do not emit the LOOP and RCL instructions. On the other hand, 
these instructions are well-known to coders who like to code directly in assembly 
language. If you spot these, it can be said that there is a high probability that this 
fragment of code was hand-written. Such instructions are marked as (M) in the 
instructions list in this appendix: .1.6 on page 1297. 


Also the function prologue/epilogue are not commonly present in hand-written as- 
sembly. 


Commonly there is no fixed system for passing arguments to functions in the hand- 
written code. 


Example from the Windows 2003 kernel (ntoskrnl.exe file): 


MultiplyTest proc near ; CODE XREF: Get386Stepping 
xor CX, CX 

loc 620555: ; CODE XREF: MultiplyTest+E 
push CX 
call Multiply 
pop cx 
jb short locret 620563 
loop loc 620555 
clc 

locret 620563: ; CODE XREF: MultiplyTest+C 
retn 


MultiplyTest endp 


Multiply proc near ; CODE XREF: MultiplyTest+5 
mov ecx, 81h 
mov eax, 417A000h 
mul ecx 
cmp edx, 2 
stc 
jnz short locret 62057F 
cmp eax, O0FE7A000h 
stc 
jnz short locret 62057F 
clc 
locret 62057F: ; CODE XREF: Multiply+10 
; Multiply+18 
retn 


Multiply endp 


Indeed, if we look in the WRKI? v1.2 source code, this code can be found easily in 
file 
WRK-v1.2\base\ntos\ke\i386\cpu.asm. 


19Windows Research Kernel 
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As of RCL instruction, | can find it in the ntoskrnl.exe file in Windows 2003 x86 (com- 
piled with MS Visual C compiler). It is occurred only once there, 
in RELExtendedLargeIntegerDivide() function, and this might be inline assembler 
code case. 


5.9 Using magic numbers while tracing 


Often, our main goal is to understand how the program uses a value that has been 
either read from file or received via network. The manual tracing of a value is often 
a very labor-intensive task. One of the simplest techniques for this (although not 
10096 reliable) is to use your own magic number. 


This resembles X-ray computed tomography is some sense: a radiocontrast agent is 
injected into the patient's blood, which is then used to improve the visibility of the 
patient's internal structure in to the X-rays. It is well known how the blood of healthy 
humans percolates in the kidneys and if the agent is in the blood, it can be easily 
seen on tomography, how blood is percolating, and are there any stones or tumors. 


We can take a 32-bit number like Ox0badf00d, or someone's birth date like 0x11101979 
and write this 4-byte number to some point in a file used by the program we inves- 
tigate. 


Then, while tracing this program with tracer in code coverage mode, with the help of 
grep or just by searching in the text file (of tracing results), we can easily see where 
the value has been used and how. 


Example of grepable tracer results in cc mode: 


0x150bf66 (_kziaia+0x14), e= 1 [MOV EBX, [EBP+8]] [EBP+8]=0xf59c934 

Ox150bf69 (_kziaia+0x17), e= 1 [MOV EDX, [69AEB08h]] [69AEB08h]-0 

Ox150bf6f (_kziaia+0x1d), e= 1 [FS: MOV EAX, [2Ch]] 

0x150bf75 (_kziaia+0x23), e= 1 [MOV ECX, [EAX+EDX*4]] [EAX+EDX*4]=0 7 
V xflac360 

0x150bf78 (_kziaia+0x26), e= 1 [MOV [EBP-4], ECX] ECX=0xflac360 


This can be used for network packets as well. It is important for the magic number 
to be unique and not to be present in the program's code. 


Aside of the tracer, DosBox (MS-DOS emulator) in heavydebug mode is able to write 
information about all registers' states for each executed instruction of the program 
to a plain text file2°, so this technique may be useful for DOS programs as well. 


5.10 Loops 


Whenever your program works with some kind of file, or buffer of some size, it has 
to be some kind of decrypting/processing loop inside of the code. 


This is a real example of tracer tool output. There was a code which loads some 
kind of encrypted file of 258 bytes. Irun it with the intention to get each instruction 


20See also my blog post about this DosBox feature: blog.yurichev.com 
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counts (a DBI tool will serve much better these days). And I quickly found a piece of 
code, which executed 259/258 times: 


0x45a6b5 e= 1 [FS: MOV [0], EAX] EAX=0x218fb08 

0x45a6bb e= 1 [MOV [EBP-254h], ECX] ECX=0x218fbd8 
0x45a6c1 e= 1 [MOV EAX, [EBP-254h]] [EBP-254h]=0x218fbd8 
0x45a6c7 e= 1 [CMP [EAX+14h], 0] [EAX+14h]=0x102 
0x45a6cb e= 1 [JZ 45A9F2h] ZF=false 

0x45a6d1 e= 1 [MOV [EBP-0Dh], 1] 

0x45a6d5 e= 1 [XOR ECX, ECX] ECX=0x218fbd8 

0x45a6d7 e= 1 [MOV [EBP-14h], CX] CX=0 

0x45a6db e= 1 [MOV [EBP-18h], 0] 

0x45a6e2 e= 1 [JMP 45A6EDh] 


0x45a6e4 e= 258 [MOV EDX, [EBP-18h]] [EBP-18h]=0..5 (248 items skipped) 07 
y xfd..0x101 

0x45a6e7 e- 258 [ADD EDX, 1] EDX=0..5 (248 items skipped) Oxfd..0x101 

0x45a6ea e= 258 [MOV [EBP-18h], EDX] EDX=1..6 (248 items skipped) Oxfe..0/ 
S x102 

0x45a6ed e= 259 [MOV EAX, [EBP-254h]] [EBP-254h]=0x218fbd8 

0x45a6f3 e= 259 [MOV ECX, [EBP-18h]] [EBP-18h]=0..5 (249 items skipped) 07 
V xfe..0x102 

0x45a6f6 e= 259 [CMP ECX, [EAX+14h]] ECX=0..5 (249 items skipped) 0xfe..07 
S x102 [EAX+14h]=0x102 

0x45a6f9 e= 259 [JNB 45A727h] CF=false,true 

0x45a6fb e= 258 [MOV EDX, [EBP-254h]] [EBP-254h]=0x218fbd8 

0x45a701 e= 258 [MOV EAX, [EDX+10h]] [EDX+10h]=0x21ee4c8 

0x45a704 e= 258 [MOV ECX, [EBP-18h]] [EBP-18h]=0..5 (248 items skipped) 07 
S xfd..0x101 

0x45a707 e- 258 [ADD ECX, 1] ECX=0..5 (248 items skipped) Oxfd..0x101 

0x45a70a e= 258 [IMUL ECX, ECX, 1Fh] ECX=1..6 (248 items skipped) 0xfe..07 
y x102 

0x45a70d e= 258 [MOV EDX, [EBP-18h]] [EBP-18h]=0..5 (248 items skipped) 07 
S xfd..0x101 

0x45a710 e= 258 [MOVZX EAX, [EAX+EDX]] [EAX+EDX]=1..6 (156 items skipped) 07 
Y Xf3, 0xf8, Oxf9, Oxfc, Oxfd 

0x45a714 e- 258 [XOR EAX, ECX] EAX=1..6 (156 items skipped) 0xf3, Oxf8, 07 
V Xf9, Oxfc, Oxfd ECX=0x1f, 0x3e, Ox5d, Ox7c, Ox9b (248 items skipped) 7 
V Oxlec2, Oxleel, Ox1f00, Oxl1flf, Ox1f3e 

0x45a716 e- 258 [MOV ECX, [EBP-254h]] [EBP-254h]=0x218fbd8 

0x45a71c e= 258 [MOV EDX, [ECX+10h]] [ECX+10h]=0x21ee4c8 

0x45a71f e= 258 [MOV ECX, [EBP-18h]] [EBP-18h]=0..5 (248 items skipped) 07 
V xfd..0x101 

0x45a722 e= 258 [MOV [EDX+ECX], AL] AL=0..5 (77 items skipped) 0xe2, Oxee, 2 
y Oxef, Oxf7, Oxfc 

0x45a725 e- 258 [JMP 45A6E4h] 

0x45a727 e- 1 [PUSH 5] 


0x45a729 e= 1 [MOV ECX, [EBP-254h]] [EBP-254h]=0x218fbd8 
0x45a72f e= 1 [CALL 45B500h] 

0x45a734 e= 1 [MOV ECX, EAX] EAX=0x218fbd8 

0x45a736 e= 1 [CALL 45B710h] 

0x45a73b e= 1 [CMP EAX, 5] EAX=5 
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As it turns out, this is the decrypting loop. 


5.10.1 Some binary file patterns 


All examples here were prepared on the Windows with active code page 437 in con- 
sole. Binary files internally may look visually different if another code page is set. 
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Arrays 


Sometimes, we can clearly spot an array of 16/32/64-bit values visually, in hex editor. 


Here is an example of array of 16-bit values. We see that the first byte in pair is 7 or 
8, and the second looks random: 


Figure 5.8: FAR: array of 16-bit values 


| used a file containing 12-channel signal digitized using 16-bit ADC?!. 


21Analog-to-Digital Converter 
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And here is an example of very typical MIPS code. 


As we may recall, every MIPS (and also ARM in ARM mode or ARM64) instruction has 
size of 32 bits (or 4 bytes), so such code is array of 32-bit values. 


By looking at this screenshot, we may see some kind of pattern. 


Vertical red lines are added for clarity: 
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Figure 5.9: Hiew: very typical MIPS code 


Another example of such pattern here is book: 9.5 on page 1224. 
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Sparse files 


This is sparse file with data scattered amidst almost empty file. Each space character 
here is in fact zero byte (which is looks like space). This is a file to program FPGA 
(Altera Stratix GX device). Of course, files like these can be compressed easily, but 
formats like this one are very popular in scientific and engineering software where 
efficient access is important while compactness is not. 


Figure 5.10: FAR: Sparse file 
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Compressed file 


This file is just some compressed archive. It has relatively high entropy and visually 
looks just chaotic. This is how compressed and/or encrypted files looks like. 


Figure 5.11: FAR: Compressed file 
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CDFS22 


OS installations are usually distributed as ISO files which are copies of CD/DVD discs. 
Filesystem used is named CDFS, here is you see file names mixed with some addi- 
tional data. This can be file sizes, pointers to another directories, file attributes, etc. 
This is how typical filesystems may look internally. 


Figure 5.12: FAR: ISO file: Ubuntu 15 installation CD73 


22Compact Disc File System 
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32-bit x86 executable code 


This is how 32-bit x86 executable code looks like. It has not very high entropy, 
because some bytes occurred more often than others. 


Figure 5.13: FAR: Executable 32-bit x86 code 
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BMP graphics files 


BMP files are not compressed, so each byte (or group of bytes) describes each pixel. 
l've found this picture somewhere inside my installed Windows 8.1: 


AY 


Microsoft* 


NET 


Zn — 


Figure 5.14: Example picture 


You see that this picture has some pixels which unlikely can be compressed very 
good (around center), but there are long one-color lines at top and bottom. Indeed, 
lines like these also looks as lines during viewing the file: 


Figure 5.15: BMP file fragment 
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5.10.2 Memory “snapshots” comparing 


The technique of the straightforward comparison of two memory snapshots in order 
to see changes was often used to hack 8-bit computer games and for hacking “high 
score” files. 


For example, if you had a loaded game on an 8-bit computer (there isn’t much mem- 
ory on these, but the game usually consumes even less memory) and you know that 
you have now, let’s say, 100 bullets, you can do a “snapshot” of all memory and 
back it up to some place. Then shoot once, the bullet count goes to 99, do a second 
“snapshot” and then compare both: it must be a byte somewhere which has been 
100 at the beginning, and now it is 99. 


Considering the fact that these 8-bit games were often written in assembly language 
and such variables were global, it can be said for sure which address in memory has 
holding the bullet count. If you searched for all references to the address in the 
disassembled game code, it was not very hard to find a piece of code decrementing 
the bullet count, then to write a NOP instruction there, or a couple of NOP-s, and 
then have a game with 100 bullets forever. Games on these 8-bit computers were 
commonly loaded at the constant address, also, there were not much different ver- 
sions of each game (commonly just one version was popular for a long span of time), 
so enthusiastic gamers knew which bytes must be overwritten (using the BASIC’s 
instruction POKE) at which address in order to hack it. This led to “cheat” lists that 
contained POKE instructions, published in magazines related to 8-bit games. 


Likewise, it is easy to modify “high score” files, this does not work with just 8-bit 
games. Notice your score count and back up the file somewhere. When the “high 
score” count gets different, just compare the two files, it can even be done with the 
DOS utility FC?* (“high score” files are often in binary form). 


There will be a point where a couple of bytes are different and it is easy to see which 
ones are holding the score number. However, game developers are fully aware of 
such tricks and may defend the program against it. 


Somewhat similar example in this book is: 9.3 on page 1210. 


A real story from 1999 


There was a time of ICQ messenger's popularity, at least in ex-USSR countries. The 
messenger had a peculiarity — some users didn't want to share their online status 
with everyone. And you had to ask an authorization from that user. That user could 
allow you seeing his/her status, or maybe not. 


This is what the author of these lines did: 
* Added a user. 
* Auser appeared in a contact-list, in a "wait for authorization" section. 
* Closed ICQ. 
* Backed up the ICQ database. 


24MS-DOS utility for comparing binary files 
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* Loaded ICQ again. 
* User authorized. 
* Closed ICQ and compared two databases. 


It turned out: two database differed by only one byte. In the first version: RESU\x03, 
in the second: RESU\x@2. ("RESU", presumably, means "USER", i.e., a header of a 
structure where all the information about user was stored.) That means the informa- 
tion about authorization was stored not at the server, but at the client. Presumably, 
2/3 value reflected authorization status. 


Windows registry 


It is also possible to compare the Windows registry before and after a program in- 
stallation. 


It is a very popular method of finding which registry elements are used by the pro- 
gram. Perhaps, this is the reason why the "windows registry cleaner" shareware is 
so popular. 


By the way, this is how to dump Windows registry to text files: 


reg export HKLM HKLM. reg 
reg export HKCU HKCU. reg 
reg export HKCR HKCR. reg 
reg export HKU HKU. reg 

reg export HKCC HKCC. reg 


They can be compared using diff... 


Engineering software, CADs, etc 


If a software uses proprietary files, you can also investigate something here as well. 
You save file. Then you add a dot or line or another primitive. Save file, compare. 
Or move dot, save file, compare. 


Blink-comparator 


Comparison of files or memory snapshots remind us blink-comparator ??: a device 
used by astronomers in past, intended to find moving celestial objects. 


Blink-comparator allows to switch quickly between two photographies shot in differ- 
ent time, so astronomer would spot the difference visually. 


By the way, Pluto was discovered by blink-comparator in 1930. 


?5https://en.wikipedia.org/wiki/Blink comparator 
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5.11 ISA detection 
Often, you can deal with a binary file for an unknown ISA. Perhaps, easiest way to 


detect ISA is to try various ones in IDA, objdump or another disassembler. 


To achieve this, one should understand a difference between incorrectly disassem- 
bled code and correctly one. 


5.11.1 Incorrectly disassembled code 


Practicing reverse engineers often have to deal with incorrectly disassembled code. 


Disassembling from an incorrect start (x86) 


Unlike ARM and MIPS (where any instruction has a length of 2 or 4 bytes), x86 in- 
structions have variable size, so any disassembler that starts in the middle of a x86 
instruction may produce incorrect results. 


As an example: 


add [ebp-31F7Bh], cl 

dec dword ptr [ecx-3277Bh] 
dec dword ptr [ebp-2CF7Bh] 
inc dword ptr [ebx-7A76F33Ch] 
fdiv st(4), st 

db OFFh 

dec dword ptr [ecx-21F7Bh] 
dec dword ptr [ecx-22373h] 
dec dword ptr [ecx-2276Bh] 
dec dword ptr [ecx-22B63h] 
dec dword ptr [ecx-22F4Bh] 
dec dword ptr [ecx-23343h] 
jmp dword ptr [esi-74h] 
xchg eax, ebp 

clc 

std 

db OFFh 

db OFFh 

mov word ptr [ebp-214h], cs ; «- disassembler finally found right track 
jy ets word ptr [ebp-238h], ds 
mov word ptr [ebp-23Ch], es 
mov word ptr [ebp-240h], fs 
mov word ptr [ebp-244h], gs 
pushf 

pop dword ptr [ebp-210h] 
mov eax, [ebp+4] 

mov [ebp-218h], eax 

lea eax, [ebp+4] 

mov [ebp-20Ch], eax 

mov dword ptr [ebp-2D0h], 10001h 
mov eax, [eax-4] 

mov [ebp-21Ch], eax 
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mov eax, [ebp+0Ch] 
mov [ebp-320h], eax 
mov eax, [ebp+10h] 
mov [ebp-31Ch], eax 
mov eax, [ebp+4] 

mov [ebp-314h], eax 
call ds: IsDebuggerPresent 
mov edi, eax 

lea eax, [ebp-328h] 
push eax 

call sub 407663 

pop ecx 

test eax, eax 

jnz short loc 402D7B 


There are incorrectly disassembled instructions at the beginning, but eventually the 
disassembler gets on the right track. 


How does random noise looks disassembled? 


Common properties that can be spotted easily are: 


* Unusually big instruction dispersion. The most frequent x86 instructions 
are PUSH, MOV, CALL, but here we see instructions from all instruction groups: 
FPU instructions, IN/OUT instructions, rare and system instructions, everything 
mixed up in one single place. 


* Big and random values, offsets and immediates. 


Jumps having incorrect offsets, often jumping in the middle of another instruc- 


tions. 
Listing 5.7: random noise (x86) 
mov bl, OCh 
mov ecx, 0D38558Dh 
mov eax, ds:2C869A86h 
db 67h 
mov dl, OCCh 
insb 
movsb 
push eax 
xor [edx-53h], ah 
fcom qword ptr [edi-45A0EF72h] 
pop esp 
pop SS 
in eax, dx 
dec ebx 
push esp 
lds esp, [esi-41h] 
retf 
rct dword ptr [eax], cl 
mov cl, 9Ch 
mov ch, ODFh 
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push CS 

insb 

mov esi, 0D9C65E4Dh 
imul ebp, [ecx], 66h 
pushf 

sal dword ptr [ebp-64h], cl 
sub eax, 0AC433D64h 
out 8Ch, eax 

pop SS 

sbb [eax], ebx 

aas 


xchg cl, [ebx+ebx*4+14B31Eh] 
jecxz short near ptr loc 5841 
xor al, 0C6h 


inc edx 

db 36h 

pusha 

stosb 

test [ebx], ebx 
sub al, 0D3h ; 'L' 
pop eax 

stosb 


loc 58: ; CODE XREF: seg000:0000004A 


test [esi], eax 

inc ebp 

das 

db 64h 

pop ecx 

das 

hlt 

pop edx 

out OBOh, al 

lodsb 

push ebx 

cdq 

out dx, al 

sub al, OAh 

sti 

outsd 

add dword ptr [edx], 96FCBE4Bh 
and eax, 0E537EE4Fh 
inc esp 

stosd 

cdq 

push ecx 

in al, OCBh 

mov ds:0D114C45Ch, al 
mov esi, 659D1985h 


Listing 5.8: random noise (x86-64) 


lea esi, [rax+rdx*4+43558D29h] 
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loc AF3: ; 
rct 
lea 
mov 
mov 
push 
lods 


loc B3D: ; 
mov 
jnz 
out 
cwde 
mov 
movsb 
pop 


CODE XREF: seg000:0000000000000B46 


byte ptr [rsi+rax*8+29BB423Ah], 1 
ecx, cs:QFFFFFFFFB2A6780Fh 

al, 96h 

ah, OCEh 

rsp 

byte ptr [esi] 


if 


rsp 
64h 
0E993h 


ah, [rax+4Ah] 

rsi, dword ptr [rbp-25h] 
4Ah 

rdi, dword ptr [rdi+rdx*8] 


byte ptr [rax+1Dh], cl 


[rbp+6CF20173h], edx 
[rbp+66F8B593h], edx 
rbx 

ch, [rbx-0Fh] 


87h 

46h, 4Ch 
33h, rax 
eax, ebp 
ecx, ebp 


rsp 


eax, esi 
rdi 


CODE XREF: seg000:0000000000000B5F 


ds:93CA685DF98A90F9h, eax 
short near ptr loc AF3+6 
dx, eax 

bh, 5Dh ; ']' 


rbp 
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Listing 5.9: random noise (ARM (ARM mode)) 


BLNE 
BGE 
SVCCS 
STRNVT 
LDCGE 
STCCSL 
CMNHIP 


OxFE16A9D8 

0x1634D0C 

0x450685 

R5, [PC],#-0x964 

p6, c14, [RO] ,#0x168 
p9, c9, [LR] ,#0x14C 
PC, R10,LSL#22 


FLDMIADNV LR!, {D4} 


MCR 
BLGE 
BLGT 
STRNEB 
STMNEIB 
STMIA 
STRB 
LDCCS 
LDRGE 
STRNEB 
STCCSL 
RSBLS 
SVCGT 
SVCGT 
STMNEDB 


LDMVSIB 
USATNE 
LDRGEB 
STRPLT 
LDRLT 
SVCNV 
MVNNVS 
LDCL 
STCNEL 
SVCNV 
BLX 
TEQGE 
STMLSIA 
BICPLS 
BNE 
TEQGE 
SUBS 
BICVS 
LDRMI 
BLMI 
STMVCDB 
EORMI 
MCRRCS 


p5, 2, R2,c15,c6, 4 
0x1139558 

OxFF9146E4 

R5, [R4],#0xCA2 

R5, (RO,R4,R6,R7,R9-SP,PC) 
R8, {RO,R2-R4,R7,R8,R10,SP,LR}* 
SP, [R8],PC,ROR#18 

p9, c13, [R6,#0x1BC] 
R8, [R9,#0x66E] 

R5, [R8],£-0x8C3 

p15, c9, [R7,£-0x84] 
LR, R2, R11,ASR LR 
0x9B0362 

0xA73173 

R11!, XRO,R1,R4-R6,R8,R10,R11,SP)? 
RO, [R3],#-0xCE4 

p15, c8, [R1,#0x2CC] 
R1, [R11],-R7,ROR#30 
OxFED9D58C 

0x13E60F4 

R3!, {R1,R4-R7}* 

R10, #7, SP,LSL#11 

LR, [R1] ,#0xE56 

R9, [LR] ,#0x567 

R11, [R1],#-0x29B 
0x12DB29 

R5, SP,LSL#25 

p8, c14, [R12,#-0x288] 
p2, c6, [R6,#-O0xBC]! 
Ox2E5A2F 

0x1A8C97E 

R3, #0x1100000 

R6, {R3,R6,R10,R11, SP} 
R12, R2, #0x5800 
0x7CC408 

R2, R4,LSL#20 

R1, R11, #0x28C 

R3, R12, R7,ASR RO 

R7, [LR],R3,LSL#21 
0x1A79234 

R6, {RO-R3,R6,R7,R10,R11} 
R12, R6, #0xC5 

pl, OxF, R1,R3,c2 
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Listing 5.10: random noise (ARM (Thumb mode)) 


LSRS R3, R6, #0x12 
LDRH R1, [R7,#0x2C] 
SUBS RO, 40x55 ; 'U' 


ADR R1, loc 3C 

LDR R2, [SP,#0x218] 
CMP RA, #0x86 

SXTB R7, R4 

LDR R4, [R1,#0x4C] 
STR RA, [R4,R2] 

STR RO, [R6,#0x20] 
BGT OxFFFFFF72 


LDRH R7, [R2,#0x34] 
LDRSH RO, [R2,R4] 
LDRB R2, [R7,R2] 


DCB 0x17 
DCB OxED 


STRB R3, [R1,R1] 
STR R5, [RO,#0x6C] 
LDMIA R3, {RO-R5,R7} 
ASRS R3, R2, #3 


LDR R4, [SP,#0x2C4] 
SVC OxB5 

LDR R6, [R1,#0x40] 
LDR R5, =0xB2C5CA32 
STMIA R6, {R1-R4,R6} 
LDR R1, [R3,#0x3C] 
STR R1, [R5,#0x60] 
BCC OxFFFFFF70 

LDR R4, [SP,#0x1D4] 
STR R5, [R5,#0x40] 


ORRS R5, R7 


loc_3C ; DATA XREF: ROM:00000006 
B OXFFFFFF98 


Listing 5.11: random noise (MIPS little endian) 


lw $t9, OxCB3($t5) 
sb $t5, 0x3855($t0) 
sltiu $a2, $a0, -0x657A 
ldr $t4, -0x4D99($a2) 
daddi $s0, $51, 0x50A4 
lw $s7, -0x2353($s4) 
bgtzl $al, 0x17C5C 


.byte 0x17 
.byte OxED 
.byte 0x4B 
.byte 0x54 


++ 
-— A 
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lwc2 $31, 0x66C5($sp) 
lwu $s1, 0x10D3($a1) 
ldr $t6, -0x204B($zero) 
lwcl $130, 0x4DBE($52) 
daddiu $t1, $s1, Ox6BD9 


lwu $s5, -0x2C64($v1) 
cop0 0x13D642D 

bne $gp, $t4, OxFFFF9EFO 
lh $ra, 0x1819($s1) 

sdl $fp, -0x6474($t8) 
jal 0x78C0050 

ori $v0, $s2, 0xC634 
blez $gp, OxFFFEA9D4 

swl $t8, -0x2CD4($s2) 


sltiu $al, $k0, 0x685 
sdcl $f15, 0x5964($at) 


SW $s0, -0x19A6($a1) 
sltiu $t6, $a3, -0x66AD 
lb $t7, -Ox4F6($t3) 
sd $fp, Ox4B02($al) 


It is also important to keep in mind that cleverly constructed unpacking and decryp- 
tion code (including self-modifying) may looks like noise as well, but still execute 
correctly. 


5.11.2 Correctly disassembled code 


Each ISA has a dozen of a most used instructions, all the rest are used much less 
often. 


As of x86, it is interesting to know that the fact that function calls (PUSH/CALL/ADD) 
and MOV instructions are the most frequently executed pieces of code in almost all 
programs we use. In other words, CPU is very busy passing information between 
levels of abstractions, or, it can be said, it's very busy switching between these 
levels. Regardless type of ISA. This is a cost of splitting problems into several levels 
of abstractions (so humans could work with them easier). 


5.12 Other things 


5.12.1 General idea 


A reverse engineer should try to be in programmer's shoes as often as possible. To 
take his/her viewpoint and ask himself, how would one solve some task the specific 
case. 


5.12.2 Order of functions in binary code 


All functions located in a single .c or .cpp-file are compiled into corresponding object 
(.0) file. Later, a linker puts all object files it needs together, not changing order of 
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functions in them. As a consequence, if you see two or more consecutive functions, 
it means, that they were placed together in a single source code file (unless you're 
on border of two object files, of course.) This means these functions have something 
in common, that they are from the same API level, from the same library, etc. 


This is a real story from practice: once upon a time, the author searched for Twofish- 
related functions in a program with CryptoPP library linked, especially encryption/de- 
cryption functions. 

| found the Twofish: :Base: :UncheckedSetKey() function, but not others. After 
peeking into the twofish.cpp source code ?*, it became clear that all functions are 
located in one module (twofish.cpp). 

So | tried all function that followed Twofish: :Base: : UncheckedSetKey ( ) —as it hap- 
pened, 

one was Twofish::Enc: :ProcessAndXorBlock(), 

another—Twofish: :Dec: :ProcessAndXorBlock(). 


5.12.3 Tiny functions 


Tiny functions like empty functions (1.3 on page 7) or function which returns just 
"true" (1) or “false” (0) (1.4 on page 10) are very common, and almost all decent 
compilers tend to put only one such function into resulting executable code even 
if there were several similar functions in source code. So, whenever you see a tiny 
function consisting just of mov eax, 1 / ret which is referenced (and can be called) 
from many places, which are seems unconnected to each other, this may be a result 
of such optimization. 


5.12.4 C++ 
RTTI (3.21.1 on page 703)-data may be also useful for C++ class identification. 


5.12.5 Crash on purpose 


Often you need to know, which function has been executed, and which is not. You 
can use a debugger, but on exotic architectures there may not be the one, so easiest 
way is to put there an invalid opcode, or something like INT3 (OxCC). The crash would 
signal about the very fact this instruction has been executed. 


Another example of crashing on purpose: 3.23.4 on page 770. 


26https://github.com/weidail1/cryptopp/blob/b613522794a7633aa2bd81932a98a0b0a51bc04f/ 
twofish.cpp 
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OS-specific 


6.1 Arguments passing methods (calling conventions) 


6.1.1 cdecl 


This is the most popular method for passing arguments to functions in the C/C++ 
languages. 


The glscaller also must return the value of the stack pointer (ESP) to its initial state 
after the callee function exits. 


Listing 6.1: cdecl 


push arg3 

push arg2 

push argl 

call function 

add esp, 12 ; returns ESP 


6.1.2 stdcall 


It's almost the same as cdecl, with the exception that the callee must set ESP to the 
initial state by executing the RET x instruction instead of RET, 

where x = arguments number * sizeof(int)!. The calleris not adjusting the stack 
pointer, there are no add esp, xinstruction. 


Listing 6.2: stdcall 


push arg3 
push arg2 
push argl 
call function 


function: 


1The size of an int type variable is 4 in x86 systems and 8 in x64 systems 
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;... do something ... 
ret 12 


The method is ubiquitous in win32 standard libraries, but not in win64 (see below 
about win64). 


For example, we can take the function from 1.90 on page 125 and change it slightly 
by adding the stdcall modifier: 


int  stdcall f2 (int a, int b, int c) 
{ 


ur 


return a*b+c; 


It is to be compiled in almost the same way as 1.91 on page 125, but you will see 
RET 12 instead of RET. SP is not updated in the caller. 


As a consequence, the number of function arguments can be easily deduced from 
the RETN n instruction: just divide n by 4. 


Listing 6.3: MSVC 2010 


_a$ = 8 ; size = 4 
_b$ = 12 ; size = 4 
_c$ = 16 ; Size = 4 
 f2012 PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR a$[ebp] 
imul eax, DWORD PTR _b$[ebp] 
add eax, DWORD PTR _c$[ebp] 
pop ebp 
ret 12 
 f2012 ENDP 
push 3 
push 2 
push 1 
call  f2Q12 
push eax 
push OFFSET $5681369 
call _printf 
add esp, 8 


Functions with variable number of arguments 


printf ()-like functions are, probably, the only case of functions with a variable 
number of arguments in C/C++, but it is easy to illustrate an important difference 
between cdecl and stdcall with their help. Let's start with the idea that the compiler 
knows the argument count of each printf() function call. 
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However, the called printf(), which is already compiled and located in MSVCRT.DLL 
(if we talk about Windows), does not have any information about how much argu- 
ments were passed, however it can determine it from the format string. 


Thus, if printf() would be a stdcall function and restored stack pointer to its initial 
state by counting the number of arguments in the format string, this could be a 
dangerous situation, when one programmer's typo can provoke a sudden program 
crash. Thus it is not suitable for such functions to use stdcall, cdecl is better. 


6.1.3 fastcall 


That's the general naming for the method of passing some arguments via registers 
and the rest via the stack. It worked faster than cdecl/stdcall on older CPUs (because 
of smaller stack pressure). It may not help to gain any significant performance on 
latest (much more complex) CPUs, however. 


It is not standardized, so the various compilers can do it differently. It’s a well known 
caveat: if you have two DLLs and the one uses another one, and they are built by 
different compilers with different fastcall calling conventions, you can expect prob- 
lems. 


Both MSVC and GCC pass the first and second arguments via ECX and EDX and the 
rest of the arguments via the stack. 


The stack pointer must be restored to its initial state by the callee (like in stdcall). 


Listing 6.4: fastcall 


push arg3 

mov edx, arg2 
mov ecx, argl 
call function 


function: 
. do something .. 
ret 4 


For example, we may take the function from 1.90 on page 125 and change it slightly 
by addinga___fastcall modifier: 


int _ fastcall f3 (int a, int b, int c) 
1 


ur 


return a*b+c; 


Here is how it is to be compiled: 


Listing 6.5: Optimizing MSVC 2010 /ObO 


_c$ = 8 ; size = 4 
@f3@12 PROC 
; a$ = ecx 
; b$ = edx 
mov eax, ecx 
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imul eax, edx 
add eax, DWORD PTR c$[esp-4] 
ret 4 


@f3@12 ENDP 


mov edx, 2 

push 3 

lea ecx, DWORD PTR [edx-1] 
call @f3@12 

push eax 

push OFFSET $5G81390 

call  printf 

add esp, 8 


We see that the callee returns SP by using the RETN instruction with an operand. 


Which implies that the number of arguments can be deduced easily here as well. 


GCC regparm 


It is the evolution of fastcall? in some sense. With the -mregparm option it is possible 
to set how many arguments are to be passed via registers (3 is the maximum). Thus, 
the EAX, EDX and ECX registers are to be used. 


Of course, if the number the of arguments is less than 3, not all 3 registers are to be 
used. 


The caller restores the stack pointer to its initial state. 
For example, see (1.28.1 on page 384). 


Watcom/OpenWatcom 


Here it is called "register calling convention". The first 4 arguments are passed via 
the EAX, EDX, EBX and ECX registers. All the rest—via the stack. 


These functions have an underscore appended to the function name in order to dis- 
tinguish them from those having a different calling convention. 


6.1.4 thiscall 


This is passing the object's this pointer to the function-method, in C++. 
In MSVC, this is usually passed in the ECX register. 


In GCC, the this pointer is passed as the first function-method argument. Thus it will 
be visible that all functions in assembly code have an extra argument, in comparison 
with the source code. 


For an example, see (3.21.1 on page 683). 


?http: //www.ohse.de/uwe/articles/gcc-attributes.htmU£func- regparm 
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6.1.5 x86-64 
Windows x64 


The method of for passing arguments in Win64 somewhat resembles fastcall. The 
first 4 arguments are passed via RCX, RDX, R8 and R9, the rest—via the stack. The 
caller also must prepare space for 32 bytes or 4 64-bit values, so then the callee can 
save there the first 4 arguments. Short functions may use the arguments' values 
just from the registers, but larger ones may save their values for further use. 


The caller also must return the stack pointer into its initial state. 


This calling convention is also used in Windows x86-64 system DLLs (instead of std- 
call in win32). 


Example: 


#include <stdio.h> 


void fl(int a, int b, int c, int d, int e, int f, int g) 


1 
printf ("sd %d %d %d %d %d *din", a, b, c, d, e, f, 9); 
$; 
int main() 
1 
f1(1,2,3,4,5,6,7); 
$; 

Listing 6.6: MSVC 2012 /Ob 
$5G2937 DB '%d %d %d %d %d %d %d', OaH, OOH 
main PROC 

sub rsp, 72 
mov DWORD PTR [rsp+48], 7 
mov DWORD PTR [rsp+40], 6 
mov DWORD PTR [rsp+32], 5 
mov rod, 4 
mov r8d, 3 
mov edx, 2 
mov ecx, 1 
call fl 
xor eax, eax 
add rsp, 72 
ret 0 
main ENDP 
a$ = 80 
b$ = 88 
c$ = 96 
d$ = 104 
e$ = 112 
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f$ - 120 

g$ - 128 

f1 PROC 

$LN3 
mov DWORD PTR [rsp+32], r9d 
mov DWORD PTR [rsp+24], r8d 
mov DWORD PTR [rsp+16], edx 
mov DWORD PTR [rsp+8], ecx 
sub rsp, 72 
mov eax, DWORD PTR g$[rsp] 
mov DWORD PTR [rsp+56], eax 
mov eax, DWORD PTR f$[rsp] 
mov DWORD PTR [rsp+48], eax 
mov eax, DWORD PTR e$[rsp] 
mov DWORD PTR [rsp+40], eax 
mov eax, DWORD PTR d$[rsp] 
mov DWORD PTR [rsp+32], eax 
mov r9d, DWORD PTR c$[rsp] 
mov r8d, DWORD PTR b$[rsp] 
mov edx, DWORD PTR a$[rsp] 
lea rcx, OFFSET FLAT: $SG2937 
call printf 
add rsp, 72 
ret 0 

fl ENDP 


Here we clearly see how 7 arguments are passed: 4 via registers and the remaining 
3 via the stack. 


The code of the f1() function’s prologue saves the arguments in the “scratch space” — 
a space in the stack intended exactly for this purpose. 


This is arranged so because the compiler cannot be sure that there will be enough 
registers to use without these 4, which will otherwise be occupied by the arguments 
until the function's execution end. 


The "scratch space" allocation in the stack is the caller's duty. 


Listing 6.7: Optimizing MSVC 2012 /Ob 


$5G2777 DB '%d %d %d %d %d %d %d', OaH, OOH 
a$ = 80 
b$ = 88 
c$ = 96 
d$ = 104 
e$ - 112 
f$ = 120 
g$ - 128 
f1 PROC 
$LN3 
sub rsp, 72 
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mov eax, DWORD PTR g$[rsp] 
mov DWORD PTR [rsp+56], eax 
mov eax, DWORD PTR f$[rsp] 
mov DWORD PTR [rsp+48], eax 
mov eax, DWORD PTR e$[rsp] 
mov DWORD PTR [rsp+40], eax 
mov DWORD PTR [rsp+32], r9d 
mov r9d, r8d 
mov r8d, edx 
mov edx, ecx 
lea rcx, OFFSET FLAT:$5G2777 
call printf 
add rsp, 72 
ret 0 

f1 ENDP 

main PROC 
sub rsp, 72 
mov edx, 2 
mov DWORD PTR [rsp+48], 7 
mov DWORD PTR [rsp+40], 6 
lea r9d, QWORD PTR [rdx+2] 
lea r8d, QWORD PTR [rdx+1] 
lea ecx, QWORD PTR [rdx-1] 
mov DWORD PTR [rsp+32], 5 
call f1 
xor eax, eax 
add rsp, 72 
ret 0 

main ENDP 


If we compile the example with optimizations, it is to be almost the same, but the 
"scratch space" will not be used, because it won't be needed. 


Also take a look on how MSVC 2012 optimizes the loading of primitive values into 
registers by using LEA (.1.6 on page 1299). MOV would be 1 byte longer here (5 
instead of 4). 


Another example of such thing is: 8.2.1 on page 1017. 
Windows x64: Passing this (C/C++) 


The this pointer is passed in RCX, the first argument of the method is in RDX, etc. For 
an example see: 3.21.1 on page 686. 
Linux x64 


The way arguments are passed in Linux for x86-64 is almost the same as in Windows, 
but 6 registers are used instead of 4 (RDI, RSI, RDX, RCX, R8, R9) and there is no 
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"scratch space", although the callee may save the register values in the stack, if it 
needs/wants to. 


Listing 6.8: Optimizing GCC 4.7.3 


.LC0: 
.String "%d %d %d %d %d %d din" 
fl: 
sub rsp, 40 
mov eax, DWORD PTR [rsp+48] 
mov DWORD PTR [rsp+8], r9d 
mov r9d, ecx 
mov DWORD PTR [rsp], r8d 
mov ecx, esi 
mov r8d, edx 
mov esi, OFFSET FLAT: .LCO 
mov edx, edi 
mov edi, 1 
mov DWORD PTR [rsp+16], eax 
xor eax, eax 
call . printf chk 
add rsp, 40 
ret 
main: 
sub rsp, 24 
mov r9d, 6 
mov rad, 5 
mov DWORD PTR [rsp], 7 
mov ecx, 4 
mov edx, 3 
mov esi, 2 
mov edi, 1 
call f1 
add rsp, 24 
ret 


N.B.: here the values are written into the 32-bit parts of the registers (e.g., EAX) but 
not in the whole 64-bit register (RAX). This is because each write to the low 32-bit 
part of a register automatically clears the high 32 bits. Supposedly, it was decided 
in AMD to do so to simplify porting code to x86-64. 


6.1.6 Return values of float and double type 


In all conventions except in Win64, the values of type float or double are returned 
via the FPU register ST (0). 


In Win64, the values of float and double types are returned in the low 32 or 64 bits 
of the XMMO register. 
6.1.7 Modifying arguments 


Sometimes, C/C++ programmers (not limited to these PLs, though), may ask, what 
can happen if they modify the arguments? 
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The answer is simple: the arguments are stored in the stack, that is where the mod- 
ification takes place. 


The calling functions is not using them after the callee's exit (the author of these 
lines has never seen any such case in his practice). 


#include <stdio.h> 


void f(int a, int b) 


{ 

a=a+b; 

printf ("sdin", a); 
}; 

Listing 6.9: MSVC 2012 

_a$ = 8 ; Size = 4 
_b$ = 12 ; size = 4 
_f PROC 

push ebp 

mov ebp, esp 

mov eax, DWORD PTR a$[ebp] 

add eax, DWORD PTR _b$[ebp] 

mov DWORD PTR _a$[ebp], eax 

mov ecx, DWORD PTR _a$[ebp] 

push ecx 

push OFFSET $5G2938 ; '%d', 0aH 

call _printf 

add esp, 8 

pop ebp 

ret 0 

f ENDP 


So yes, one can modify the arguments easily. Of course, if it is not references in C++ 
(3.21.3 on page 705), and if you don't modify data to which a pointer points to, then 
the effect will not propagate outside the current function. 


Theoretically, after the callee's return, the caller could get the modified argument 
and use it somehow. Maybe if it is written directly in assembly language. 


For example, code like this will be generated by usual C/C++ compiler: 


push 456 ; will be b 

push 123 ; will be a 

call f ; f() modifies its first argument 
add esp, 2*4 


We can rewrite this code like: 


push 456 ; will be b 

push 123 ; will be a 

call f ; f() modifies its first argument 
pop eax 

add esp, 4 


; EAX=1st argument of f() modified in f() 
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Hard to imagine, why anyone would need this, but this is possible in practice. Nev- 
ertheless, the C/C++ languages standards don't offer any way to do so. 


6.1.8 Taking a pointer to function argument 


...even more than that, it's possible to take a pointer to the function's argument and 
pass it to another function: 


#include <stdio.h> 


// located in some other file 
void modify a (int *a); 


void f (int a) 
1 
modify a (&a); 
printf ("%d\n", a); 
Is 


It's hard to understand how it works until we can see the code: 


Listing 6.10: Optimizing MSVC 2010 


$SG2796 DB 'Sd', OaH, 00H 
_a$ = 8 
_f PROC 
lea eax, DWORD PTR a$[esp-4] ; just get the address of value in 
local stack i 
eax ; and pass it to modify a() 
call modify a 
mov ecx, DWORD PTR _a$[esp] ; reload it from the local stack 
push ecx ; and pass it to printf() 
push OFFSET $SG2796 ; '%d' 
call _printf 
add esp, 12 
ret 0 


f ENDP 


The address of the place in the stack where a has been passed is just passed to 
another function. It modifies the value addressed by the pointer and then printf () 
prints the modified value. 


The observant reader might ask, what about calling conventions where the function's 
arguments are passed in registers? 


That's a situation where the Shadow Space is used. 


The input value is copied from the register to the Shadow Space in the local stack, 
and then this address is passed to the other function: 


Listing 6.11: Optimizing MSVC 2012 x64 


$SG2994 DB '*sd', OaH, OOH 
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a$ - 48 

f PROC 
mov DWORD PTR [rsp+8], ecx ; save input value in Shadow Space 
sub rsp, 40 
lea rcx, QWORD PTR a$[rsp] ; get address of value and pass it 


to modify a() 
call modify a 


mov edx, DWORD PTR a$[rsp] ; reload value from Shadow Space and 
pass it to printf() 
lea rcx, OFFSET FLAT:$SG2994 ; '%d' 
call printf 
add rsp, 40 
ret 0 
f ENDP 


GCC also stores the input value in the local stack: 


Listing 6.12: Optimizing GCC 4.9.1 x64 


.LC0: 
.string "%d\n" 
f: 
sub rsp, 24 
mov DWORD PTR [rsp+12], edi ; store input value to the local 
rey T rdi, [rsp+12] ; take an address of the value and 


pass it to modify_a() 
call modify_a 


mov edx, DWORD PTR [rsp+12] ; reload value from the local stack 
and pass it to printf() 

mov esi, OFFSET FLAT: .LCO ; !9ed' 

mov edi, 1 

xor eax, eax 

call . printf chk 

add rsp, 24 

ret 


GCC for ARM64 does the same, but this space is called Register Save Area here: 


Listing 6.13: Optimizing GCC 4.9.1 ARM64 


f: 

stp x29, x30, [sp, -32]! 

add x29, sp, 0 ; Setup FP 

add x1, x29, 32 ; calculate address of variable in 
Register Save Area 

str w0, [x1,-4]! ; store input value there 

mov x0, x1 ; pass address of variable to the 
modify a() 

bl modify a 

ldr wl, [x29,28] ; load value from the variable and pass it 
to printf() 

adrp x0, .LCO ; '*d' 

add x0, x0, :1012:.LC0 

bl printf ; call printf() 

ldp x29, x30, [sp], 32 
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ret 
.LC0: 
.string "%d\n" 


By the way, a similar usage of the Shadow Space is also considered here: 3.17.1 on 
page 652. 
6.1.9 Python ctypes problem (x86 assembly homework) 


A Python ctypes module can call external functions in DLLs, .so's, etc. But calling 
convention (for 32-bit environment) must be specified explicitly: 


"ctypes" exports the *cdll*, and on Windows *windll* and *oledll* 
objects, for loading dynamic link libraries. 


You load libraries by accessing them as attributes of these objects. 
*cdll* loads libraries which export functions using the standard 
"cdecl" calling convention, while *windll* libraries call functions 
using the "stdcall" calling convention. 


( https://docs.python.org/3/library/ctypes.html ) 


In fact, we can modify ctypes module (or any other caller code), so that it will suc- 
cessfully call external cdecl or stdcall functions, without knowledge, which is where. 
(Number of arguments, however, is to be specified). 


This is possible to solve using maybe 5-10 x86 assembly instructions in caller. Try to 
find out these. 


6.1.10 Cdecl example: a DLL 


Let's back to the fact that this is not very important how to declare the main() func- 
tion: 1.9.2 on page 44. 


This is a real story: once upon a time | wanted to replace an original DLL file in some 
software by mine. First | enumerated names of all DLL exports and made a function 
in my own replacement DLL for each function in the original DLL, like: 


void functionl () 


1 


write to log ("functionl() called\n"); 


| wanted to see, which functions are called during run, and when. However, | was in 
hurry and had no time to deduce arguments count for each function, let alone data 
types. So each function in my replacement DLL had no argument whatsoever. But 
everything worked, because all functions had cdecl calling convention. (It wouldn't 
work if functions had stacall calling convention.) It also worked for x64 version. 


And then I did a next step: | deduced argument types for some functions. But | made 
several mistakes, for example, the original function took 3 arguments, but | knew 
only about 2, etc. 
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Still, it worked. At the beginning, my replacement DLL just ignored all arguments. 
Then, it ignored the 3rd argument. 


6.2 Thread Local Storage 


TLS is a data area, specific to each thread. Every thread can store what it needs 
there. One well-known example is the C standard global variable errno. 


Multiple threads may simultaneously call functions which return an error code in er- 
rno, So a global variable will not work correctly here for multi-threaded programs, so 
errno must be stored in the TLS. 


In the C++11 standard, a new thread local modifier was added, showing that each 
thread has its own version of the variable, it can be initialized, and it is located in 
the TLS ?: 


Listing 6.14: C++11 


#include <iostream> 
#include <thread> 


thread local int tmp=3; 


int main() 


{ 
F 


std::cout << tmp << std::endl; 


Compiled in MinGW GCC 4.8.1, but not in MSVC 2012. 


If we talk about PE files, in the resulting executable file, the tmp variable is to be 
allocated in the section devoted to the TLS. 


6.2.1 Linear congruential generator revisited 

The pseudorandom number generator we considered earlier 1.29 on page 424 has 
a flaw: it's not thread-safe, because it has an internal state variable which can be 
read and/or modified in different threads simultaneously. 

Win32 

Uninitialized TLS data 


One solution is to add declspec( thread ) modifier to the global variable, then 
it will be allocated in the TLS (line 9): 


1 |£include «stdint.h» 
2 |#include «windows.h» 
3 include <winnt.h> 


3 C11 also has thread support, optional though 
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// from the Numerical Recipes book: 
define RNG a 1664525 

define RNG c 1013904223 

. declspec( thread ) uint32 t rand state; 


void my srand (uint32 t init) 


1 
rand state-init; 
} 
int my_rand () 
{ 
rand state-rand state*RNG a; 
rand state-rand state+RNG c; 
return rand state & Ox7fff; 
} 
int main() 
{ 
my srand(0x12345678); 
printf ("%d\n", my rand()); 
$; 


Hiew shows us that there is a new PE section in the executable file: .tls. 


Listing 6.15: Optimizing MSVC 2013 x86 


_TLS SEGMENT 
_rand_state DD 01H DUP (?) 


TLS ENDS 

DATA SEGMENT 

$5G84851 DB '&d', OaH, OOH 
DATA ENDS 


TEXT | SEGMENT 


_init$ = 8 ; size = 4 
_my_srand PROC 
; FS:0=address of TIB 


mov eax, DWORD PTR fs: tls array ; displayed in IDA as FS:2Ch 
; EAX=address of TLS of process 

mov ecx, DWORD PTR tls index 

mov ecx, DWORD PTR [eax+ecx*4] 
; ECX=current TLS segment 

mov eax, DWORD PTR  init$[esp-4] 

mov DWORD PTR rand state[ecx], eax 

ret 0 


.my srand ENDP 


my rand PROC 
; FS:0=address of TIB 
mov eax, DWORD PTR fs: tls array ; displayed in IDA as FS:2Ch 
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; EAX=address of TLS of process 


mov 
mov 


ecx, DWORD PTR tls index 
ecx, DWORD PTR [eax+ecx*4] 


; ECX=current TLS segment 


imul 
add 
mov 
and 
ret 
_my_rand ENDP 


TEXT ENDS 


eax, DWORD PTR rand state[ecx], 1664525 


eax, 1013904223 ; 3c6ef35fH 
DWORD PTR rand state[ecx], eax 
eax, 32767 ; 00007fffH 
0 


rand state is now in the TLS segment, and each thread has its own version of this 


variable. 


Here is how it's accessed: load the address of the TIB from FS:2Ch, then add an 
additional index (if needed), then calculate the address of the TLS segment. 


Then it's possible to access the rand state variable through the ECX register, which 
points to an unique area in each thread. 


The FS: selector is familiar to every reverse engineer, it is specially used to always 
point to TIB, so it would be fast to load the thread-specific data. 


The GS: selector is used in Win64 and the address of the TLS is 0x58: 


Listing 6.16: Optimizing MSVC 2013 x64 


_TLS SEGMENT 
rand state DD 
_TLS ENDS 


_DATA | SEGMENT 
$5685451 DB 
_DATA ENDS 


TEXT | SEGMENT 


init$ = 8 

my srand PROC 
mov 
mov 
mov 
mov 
mov 
ret 

my srand ENDP 


my rand PROC 
mov 
mov 
mov 
mov 
imul 


01H DUP (?) 


%d', OaH, 00H 


edx, DWORD PTR tls index 
rax, QWORD PTR gs:88 ; 58h 
r8d, OFFSET FLAT: rand state 
rax, QWORD PTR [rax+rdx*8] 
DWORD PTR [r8+rax], ecx 


rax, QWORD PTR gs:88 ; 58h 

ecx, DWORD PTR tls index 

edx, OFFSET FLAT: rand state 

rcx, QWORD PTR [rax+rcx*8] 

eax, DWORD PTR [rcx«rdx], 1664525 ; 0019660dH 
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add eax, 1013904223 ; 3c6ef35fH 
mov DWORD PTR [rcx+rdx], eax 

and eax, 32767 ; 00007fffH 
ret 0 


my rand ENDP 


TEXT ENDS 


Initialized TLS data 


Let's say, we want to set some fixed value to rand state, so in case the programmer 
forgets to, the rand state variable would be initialized to some constant anyway 
(line 9): 


#include «stdint.h» 
#include «windows.h» 
#include <winnt.h> 


// from the Numerical Recipes book: 

#define RNG_a 1664525 

#define RNG c 1013904223 

. declspec( thread ) uint32 t rand state=1234; 


void my srand (uint32 t init) 


{ 
rand_state=init; 
} 
int my_rand () 
{ 
rand state-rand state*RNG a; 
rand state-rand state+RNG c; 
return rand state € Ox7fff; 
} 
int main() 
{ 
printf ("%d\n", my rand()); 
}; 


The code is not different from what we already saw, but in IDA we see: 


.t1s:00404000 ; Segment type: Pure data 
.tls:00404000 ; Segment permissions: Read/Write 


.tls:00404000 tls segment para public 'DATA' use32 

. tls :00404000 assume cs: tls 

.t1s:00404000 ;org 404000h 

.t1s:00404000 TlsStart db 0 ; DATA XREF: 
.rdata:TlsDirectory 

.t1s:00404001 db 0 

.t1s:00404002 db 0 
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.t1s:00404003 db 0 
.t1s:00404004 dd 1234 


.tls:00404008 TlsEnd db 0 ; DATA XREF: .rdata:TlsEnd ptr 


1234 is there and every time a new thread starts, a new TLS is allocated for it, and 
all this data, including 1234, will be copied there. 


This is a typical scenario: 
* Thread A is started. A TLS is created for it, 1234 is copied to rand state. 


* The my rand() function is called several times in thread A. 
rand state is different from 1234. 


* Thread B is started. A TLS is created for it, 1234 is copied to rand state, while 
thread A has a different value in the same variable. 


TLS callbacks 


But what if the variables in the TLS have to be filled with some data that must be 
prepared in some unusual way? 


Let's say, we've gotthe following task: the programmer can forgetto callthemy srand() 
function to initialize the PRNG, but the generator has to be initialized at start with 
something truly random, instead of 1234. This is a case in which TLS callbacks can 

be used. 


The following code is not very portable due to the hack, but nevertheless, you get 
the idea. 


What we do here is define a function (tls callback()) which is to be called before 
the process and/or thread start. 


The function initializes the PRNG with the value returned by GetTickCount() func- 
tion. 


#include «stdint.h» 
#include «windows.h» 
#include <winnt.h> 


// from the Numerical Recipes book: 
#define RNG_a 1664525 

#define RNG c 1013904223 

. declspec( thread ) uint32 t rand state; 


void my srand (uint32 t init) 


1 
} 


rand state-init; 


void NTAPI tls callback(PVOID a, DWORD dwReason, PVOID b) 
1 
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my srand (GetTickCount()); 
} 


#pragma data seg(".CRT$XLB") 
PIMAGE TLS CALLBACK p thread callback - tls callback; 
#pragma data seg() 


int my rand () 


1 
rand state-rand state*RNG a; 
rand state-rand state+RNG c; 
return rand state & Ox7fff; 
} 
int main() 
{ 
// rand state is already initialized at the moment (using 
GetTickCount()) 
printf ("%d\n", my rand()); 
$; 


Let's see it in IDA: 


Listing 6.17: Optimizing MSVC 2013 


.text:00401020 TlsCallback © proc near ; DATA XREF: 
.rdata:TlsCallbacks 
00401020 


.text: call ds:GetTickCount 
.text:00401026 push eax 
.text:00401027 call my srand 
.text:0040102C pop ecx 
.text:0040102D retn OCh 


.text:0040102D TlsCallback © endp 


.rdata:004020C0 TlsCallbacks dd offset TlsCallback © ; DATA XREF: 
.rdata:TlsCallbacks ptr 


.rdata:00402118 TlsDirectory dd offset TlsStart 
.rdata:0040211C TlsEnd ptr dd offset TlsEnd 
.rdata:00402120 TlsIndex ptr dd offset TlsIndex 
.rdata:00402124 TlsCallbacks ptr dd offset TlsCallbacks 
.rdata:00402128 TlsSizeOfZeroFill dd O 

.Fdata:0040212C TlsCharacteristics dd 300000h 


TLS callback functions are sometimes used in unpacking routines to obscure their 
processing. 


Some people may be confused and be in the dark that some code executed right 
before the OEP^. 


^Original Entry Point 
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Linux 


Here is how a thread-local global variable is declared in GCC: 


. thread uint32 t rand state-1234; 


This is not the standard C/C++ modifier, but a rather GCC-specific one ?. 
The GS: selector is also used to access the TLS, but in a somewhat different way: 
Listing 6.18: Optimizing GCC 4.8.1 x86 


.text:08048460 my srand proc near 

.text:08048460 

.text:08048460 arg 0 - dword ptr 4 
.text:08048460 

.text:08048460 mov eax, [esptarg 0] 

. text: 08048464 mov gs:OFFFFFFFCh, eax 
. text: 0804846A retn 

. text: 0804846A my srand endp 

.text:08048470 my rand proc near 

.text:08048470 imul eax, gs:OFFFFFFFCh, 19660Dh 
.text:0804847B add eax, 3C6EF35Fh 
.text:08048480 mov gs:OFFFFFFFCh, eax 
.text:08048486 and eax, 7FFFh 
.text:0804848B retn 

.text:0804848B my rand endp 


More about it: [Ulrich Drepper, ELF Handling For Thread-Local Storage, (2013)]*. 


6.3 System calls (syscall-s) 


As we know, all running processes inside an OS are divided into two categories: 
those having full access to the hardware ("kernel space") and those that do not 
("user space"). 


The OS kernel and usually the drivers are in the first category. 
All applications are usually in the second category. 
For example, Linux kernel is in kernel space, but Glibc in user space. 


This separation is crucial for the safety of the OS: it is very important not to give to 
any process the possibility to screw up something in other processes or even in the 
OS kernel. On the other hand, a failing driver or error inside the OS's kernel usually 
leads to a kernel panic or BSOD’. 


The protection in the x86 processors allows to separate everything into 4 levels of 
protection (rings), but both in Linux and in Windows only two are used: ringO ("kernel 
space") and ring3 ("user space"). 


5https://gcc.gnu.org/onlinedocs/gcc-3.3/gcc/C99- Thread-Local-Edits.html 
also available as http: //www.akkadia.org/drepper/tls.pdf 
7Blue Screen of Death 
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System calls (syscall-s) are a point where these two areas are connected. 
It can be said that this is the main API provided to applications. 
As in Windows NT, the syscalls table resides in the SSDT®. 


The usage of syscalls is very popular among shellcode and computer viruses authors, 
because it is hard to determine the addresses of needed functions in the system 
libraries, but itis easier to use syscalls. However, much more code has to be written 
due to the lower level of abstraction of the API. 


It is also worth noting that the syscall numbers may be different in various OS ver- 
sions. 


6.3.1 Linux 


In Linux, a syscall is usually called via int 0x80. The call's number is passed in the 
EAX register, and any other parameters —in the other registers. 


Listing 6.19: A simple example of the usage of two syscalls 


section .text 
global start 


start: 
mov edx,len ; buffer len 
mov ecx,msg ; buffer 
mov ebx,1 ; file descriptor. 1 is for stdout 
mov eax,4 ; Syscall number. 4 is for sys write 
int 0x80 
mov eax,1 ; Syscall number. 1 is for sys exit 
int 0x80 


section .data 


msg db 'Hello, world!',0xa 
len equ $ - msg 


Compilation: 


nasm -f elf32 1.s 
ld 1.0 


The full list of syscalls in Linux: http://syscalls.kernelgrok.com/. 


For system calls interception and tracing in Linux, strace(7.2.3 on page 1007) can 
be used. 


6.3.2 Windows 


Here they are called via int 0x2e or using the special x86 instruction SYSENTER. 


8System Service Dispatch Table 
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The full list of syscalls in Windows: http://j00ru.vexillium.org/ntapi/. 
Further reading: 


"Windows Syscall Shellcode" by Piotr Bania: http://www.symantec.com/connect/ 
articles/windows-syscall-shellcode. 


6.4 Linux 


6.4.1 Position-independent code 


While analyzing Linux shared (.so) libraries, one may frequently spot this code pat- 
tern: 


Listing 6.20: libc-2.17.so x86 


.text:0012D5E3 x86 get pc thunk bx proc near ; CODE XREF: sub 1735043 
.text:0012D5E3 ; sub 173CC44 ... 
.text:0012D5E3 mov ebx, [esp+0] 

.text:0012D5E6 retn 


.text:0012D5E6 x86 get pc thunk bx endp 


.text:000576C0 sub 576C0 proc near ; CODE XREF: tmpfile+73 

.text:000576C0 push ebp 

.text:000576C1 mov ecx, large gs:0 

.text:000576C8 push edi 

.text:000576C9 push esi 

.text:000576CA push ebx 

.text:000576CB call x86 get pc thunk bx 

.text:000576D0 add ebx, 157930h 

.text:000576D6 sub esp, 9Ch 

.text:000579F0 lea eax, (a gen tempname - 1AF000h)[ebx] ; 
" gen tempname" 

.text:000579F6 mov [esp+0ACh+var AO], eax 

. text: 000579FA lea eax, (a SysdepsPosix - 1AF000h) [ebx] ; 
"../sysdeps/posix/tempname.c" 

.text:00057A00 mov [esp+0ACh+var_ A8], eax 

. text: 00057A04 lea eax, (aInvalidKindIn_ - 1AF000h)[ebx] ; 
"1 \"invalid KIND in gen tempname\"" 

.text:00057A0A mov [esp+0ACh+var A4], 14Ah 

.text:00057A12 mov [esp+0ACh+var AC], eax 

.text:00057A15 call . assert fail 


All pointers to strings are corrected by some constants and the value in EBX, which 
is calculated at the beginning of each function. 
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This is the so-called PIC, it is intended to be executable if placed at any random point 
of memory, that is why it cannot contain any absolute memory addresses. 


PIC was crucial in early computer systems and is still crucial today in embedded 
systems without virtual memory support (where all processes are placed in a single 
continuous memory block). 


It is also still used in *NIX systems for shared libraries, since they are shared across 
many processes while loaded in memory only once. But all these processes can map 
the same shared library at different addresses, so that is why a shared library has 
to work correctly without using any absolute addresses. 


Let's do a simple experiment: 


#include <stdio.h> 
int global _variable=123; 


int fl(int var) 


1 
int rt=global_variable+var; 
printf ("returning %d\n", rt); 
return rt; 

yi 


Let's compile it in GCC 4.7.3 and see the resulting .so file in IDA: 


gcc -fPIC -shared -03 -o 1.so 1.c 


Listing 6.21: GCC 4.7.3 


.text:00000440 public x86 get pc thunk bx 

.text:00000440 . x86 get pc thunk bx proc near ; 
CODE XREF: init proc+4 

.text:00000440 ; 
deregister tm clones+4 ... 


.text:00000440 mov ebx, [esp+0] 
.text:00000443 retn 

.text:00000443 x86 get pc thunk bx endp 
.text:00000570 public f1 
.text:00000570 f1 proc near 


.text:00000570 

.text:00000570 var 1C 
.text:00000570 var 18 
.text:00000570 var 14 


dword ptr -1Ch 
dword ptr -18h 
dword ptr -14h 


.text:00000570 var 8 dword ptr -8 

.text:00000570 var 4 dword ptr -4 

.text:00000570 arg 0 dword ptr 4 

.text:00000570 

.text:00000570 sub esp, 1Ch 
.text:00000573 mov [esp+1Ch+var_8], ebx 
.text:00000577 call x86 get pc thunk bx 
.text:0000057C add ebx, 1A84h 
.text:00000582 mov [esp+1Ch+var_ 4], esi 
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.text:00000586 mov eax, ds:(global variable ptr - 2000h7 
V ) [ebx] 

.text:0000058C mov esi, [eax] 

.text:0000058E lea eax, (aReturningD - 2000h)[ebx] ; 
"returning %d\n" 

.text:00000594 add esi, [esp+1Ch+arg_0] 

. text: 00000598 mov [esp+1Ch+var_18], eax 

. text: 0000059C mov [esp+1Ch+var_1C], 1 

. text: 000005A3 mov [esp+1Ch+var_14], esi 

. text: 000005A7 call ||  printf chk 

.text:000005AC mov eax, esi 

.text:000005AE mov ebx, [esp+1Ch+var 8] 

.text:000005B2 mov esi, [esp+1Ch+var 4] 

.text:000005B6 add esp, 1Ch 

.text:000005B9 retn 

.text:000005B9 f1 endp 


That's it: the pointers to «returning %d\n» and global variable are to be corrected 
at each function execution. 


The x86 get pc thunk bx() function returns in EBX the address of the point after 
a call to itself (0x57C here). 


That's a simple way to get the value of the program counter (EIP) at some point. The 
0x1A84 constant is related to the difference between this function's start and the so- 
called Global Offset Table Procedure Linkage Table (GOT PLT), the section right after 
the Global Offset Table (GOT), where the pointer to global variable is. IDA shows 
these offsets in their processed form to make them easier to understand, but in fact 
the code is: 


.text:00000577 call x86 get pc thunk bx 
.text:0000057C add ebx, 1A84h 
.text:00000582 mov [esp+1Ch+var_4], esi 
.text:00000586 mov eax, [ebx-0Ch] 
.text:0000058C mov esi, [eax] 
.text:0000058E lea eax, [ebx-1A30h] 


Here EBX points to the GOT PLT section and to calculate a pointer to global_variable 
(which is stored in the GOT), OxC must be subtracted. 


To calculate pointer to the «returning %d\n» string, 0x1A30 must be subtracted. 


By the way, that is the reason why the AMD64 instruction set supports RIP?-relative 
addressing — to simplify PIC-code. 


Let's compile the same C code using the same GCC version, but for x64. 


IDA would simplify the resulting code but would suppress the RIP-relative addressing 
details, so we are going to use objdump instead of IDA to see everything: 


0000000000000720 <f1>: 
720: 48 8b 05 b9 08 20 00 mov rax,QWORD PTR [rip+0x2008b9] 2 


S; 
200fe0 « DYNAMIC+0x1d0> 


9program counter in AMD64 
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727: 53 push rbx 

728: 89 fb mov ebx,edi 

72a: 48 8d 35 20 00 00 00 lea rsi, [rip+0x20] : 
751 « fini+0x9> 


731: bf 01 00 00 00 mov edi, 0x1 

736: 03 18 add ebx,DWORD PTR [rax] 
738: 31 c0 xor eax,eax 

73a: 89 da mov edx,ebx 

73c: e8 df fe ff ff call 620 « printf chkgplt» 
741: 89 d8 mov eax,ebx 

743: 5b pop rbx 

744: c3 ret 


0x2008b9 is the difference between the address of the instruction at 0x720 and 
global variable, and 0x20 is the difference between the address of the instruction at 
0x72A and the «returning %d\n» string. 


As you might see, the need to recalculate addresses frequently makes execution 
slower (it is better in x64, though). 


So it is probably better to link statically if you care about performance [see: Agner 
Fog, Optimizing software in C++ (2015)]. 


Windows 


The PIC mechanism is not used in Windows DLLs. If the Windows loader needs to 
load DLL on another base address, it "patches" the DLL in memory (at the FIXUP 
places) in order to correct all addresses. 


This implies that several Windows processes cannot share an once loaded DLL at 
different addresses in different process' memory blocks — since each instance that's 
loaded in memory is fixed to work only at these addresses.. 


6.4.2 LD PRELOAD hack in Linux 


This allows us to load our own dynamic libraries before others, even before system 
ones, like libc.so.6. 


This, in turn, allows us to "substitute" our written functions before the original ones 
in the system libraries. For example, it is easy to intercept all calls to time(), read(), 
write(), etc. 


Let's see if we can fool the uptime utility. As we know, it tells how long the com- 
puter has been working. With the help of strace(7.2.3 on page 1007), it is possible 
to see that the utility takes this information the /proc/uptime file: 


$ strace uptime 


open("/proc/uptime", O RDONLY) = 3 
lseek(3, 0, SEEK SET) = 0 
= 20 


read(3, "416166.86 414629.38\n", 2047) 
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It is not a real file on disk, it is a virtual one and its contents are generated on fly in 
the Linux kernel. There are just two numbers: 


$ cat /proc/uptime 
416690.91 415152.03 


What we can learn from Wikipedia !?: 


The first number is the total number of seconds the system has 
been up. The second number is how much of that time the machine 
has spent idle, in seconds. 


Let's try to write our own dynamic library with the open(), read(), close() functions 
working as we need. 


At first, our open() will compare the name of the file to be opened with what we need 
and if it is so, it will write down the descriptor of the file opened. 


Second, read(), if called for this file descriptor, will substitute the output, and in the 
rest of the cases will call the original read() from libc.so.6. And also close(), will note 
if the file we are currently following is to be closed. 


We are going to use the dlopen() and dlsym() functions to determine the original 
function addresses in libc.so.6. 


We need them because we must pass control to the "real" functions. 


On the other hand, if we intercepted strcmp() and monitored each string compar- 
isons in the program, then we would have to implement our version of strcmp(), and 
not use the original function **, that would be easier. 


#include <stdio.h> 
#include <stdarg.h> 
#include <stdlib.h> 
#include <stdbool.h> 
#include <unistd.h> 
#include <dlfcn.h> 
#include <string.h> 


void *libc handle = NULL; 

int (*open ptr)(const char *, int) - NULL; 

int (*close ptr)(int) = NULL; 

ssize t (*read ptr)(int, void*, size t) - NULL; 


bool inited = false; 


_Noreturn void die (const char * fmt, ...) 
t 
va list va; 

va start (va, fmt); 


IOhttps://en.wikipedia.org/wiki/Uptime 
11For example, here is how simple strcmp() interception works in this article 1? written by Yong Huang 
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vprintf (fmt, va); 


exit(0); 
F; 
static void find_original_functions () 
{ 
if (inited) 
return; 
libc handle = dlopen ("libc.so.6", RTLD LAZY); 
if (libc_handle==NULL) 
die ("can't open libc.so.6Xn"); 
open ptr = dlsym (libc handle, "open"); 
if (open ptr-zNULL) 
die ("can't find open()\n"); 
close ptr = dlsym (libc handle, "close"); 
if (close ptr==NULL) 
die ("can't find close()\n"); 
read ptr = dlsym (libc handle, "read"); 
if (read ptr-zNULL) 
die ("can't find read()\n"); 
inited - true; 
} 


static int opened_fd=0; 


int open(const char *pathname, int flags) 


{ 
find_original_functions(); 
int fd=(*open_ptr)(pathname, flags); 
if (strcmp(pathname, "/proc/uptime")==0) 
opened_fd=fd; // that's our file! record its file descriptor 
else 
opened fd-0; 
return fd; 
}; 
int close(int fd) 
{ 
find_original_functions(); 
if (fd==opened_ fd) 
opened fdz0; // the file is not opened anymore 
return (*close ptr) (fd); 
}; 


ssize_t read(int fd, void *buf, size_t count) 


{ 
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find original functions(); 


if (opened fd!=0 && fd--opened fd) 
1 
// that's our file! 
return snprintf (buf, count, "sd %d", Ox7fffffff, Ov 
S X7fffffff)-1; 
u 
// not our file, go to real read() function 
return (*read ptr)(fd, buf, count); 
b 


( Source code ) 


Let's compile it as common dynamic library: 


gcc -fpic -shared -Wall -o fool uptime.so fool uptime.c -ldl 


Let's run uptime while loading our library before the others: 


LD PRELOAD-'pwd'/fool uptime.so uptime 


And we see: 


01:23:02 up 24855 days, 3:14, 3 users, load average: 0.00, 0.01, 0.05 


If the LD PRELOAD 

environment variable always points to the filename and path of our library, it is to 
be loaded for all starting programs. 

More examples: 


e Very simple interception of the strcmp() (Yong Huang) https: //yurichev.com/ 
mirrors/LD PRELOAD/Yong%20Huang%20LD PRELOAD.txt 


* Kevin Pulo—Fun with LD PRELOAD. A lot of examples and ideas. yurichev.com 


* File functions interception for compression/decompression files on fly (zlibc). 
ftp://metalab.unc.edu/pub/Linux/libs/compression 


6.5 Windows NT 
6.5.1 CRT (win32) 


Does the program execution start right at the main() function? No, it does not. 


If we would open any executable file in IDA or HIEW, we can see OEP pointing to 
some another code block. 


This code is doing some maintenance and preparations before passing control flow 
to our code. It is called startup-code or CRT code (C RunTime). 
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The main() function takes an array of the arguments passed on the command line, 
and also one with environment variables. But in fact a generic string is passed to 
the program, the CRT code finds the spaces in it and cuts it in parts. The CRT code 
also prepares the environment variables array envp. 


As for GUI? win32 applications, WinMain is used instead of main(), having its own 
arguments: 


int CALLBACK WinMain( 
.In  HINSTANCE hInstance, 
.In  HINSTANCE hPrevInstance, 
.In  LPSTR lpCmdLine, 
_In_ int nCmdShow 

E 


The CRT code prepares them as well. 
Also, the number returned by the main() function is the exit code. 


It may be passed in CRT to the ExitProcess() function, which takes the exit code 
as an argument. 


Usually, each compiler has its own CRT code. 


Here is a typical CRT code for MSVC 2008. 


|. tmainCRTStartup proc near 


var 24 - dword ptr -24h 

var 20 - dword ptr -20h 

var 1C - dword ptr -1Ch 

ms exc = CPPEH RECORD ptr -18h 
push 14h 
push offset stru 4092D0 
call .. SEH prolog4 
mov eax, 5A4Dh 
cmp ds:400000h, ax 
jnz short loc 401096 
mov eax, ds:40003Ch 
cmp dword ptr [eax+400000h], 4550h 
jnz short loc 401096 
mov ecx, 10Bh 
cmp [eax+400018h], cx 
jnz short loc 401096 
cmp dword ptr [eax+400074h], OEh 
jbe short loc 401096 
xor ecx, ecx 
cmp [eax+4000E8h], ecx 
setnz cl 
mov [ebp-var 1C], ecx 
jmp short loc 40109A 


13Graphical User Interface 
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loc 401096: 
and 


loc 40109A: 
push 
call 
pop 
test 
jnz 
push 
call 
pop 


loc 4010AE: 
call 
test 
jnz 
push 
call 
pop 


loc 4010BF: 
call 
and 
call 
test 
jge 
push 
call 
pop 


loc 4010D9: 
call 
mov 
call 
mov 
call 
test 
jge 
push 
call 
pop 


loc 4010FF: 
call 
test 
jge 
push 
call 
pop 


, 


, 


, 


, 


, 


, 


, 


CODE XREF: — tmainCRTStartup+18 
|. tmainCRTStartup+29 ... 
[ebp*-var 1C], 0 
; CODE XREF: tmainCRTStartup+50 

1 

. heap init 

ecx 

eax, eax 

short loc 4010AE 

1Ch 

fast error exit 

ecx 

; CODE XREF: tmainCRTStartup+60 

. mtinit 

eax, eax 

short loc 4010BF 

10h 

fast error exit 

ecx 
CODE XREF: tmainCRTStartup+71 
sub_401F2B 
[ebp+ms_exc.disabled], 0 

. ioinit 

eax, eax 

short loc 4010D9 

1Bh 

. amsg exit 

ecx 
CODE XREF: — tmainCRTStartup+8B 


ds:GetCommandLineA 

dword 40B7F8, eax 

|.  crtGetEnvironmentStringsA 
dword 40AC60, eax 

_ setargv 

eax, eax 

short loc 4010FF 

8 

_ amsg exit 

ecx 


; CODE XREF: tmainCRTStartup+B1 


. setenvp 

eax, eax 

short loc 401110 
9 

. amsg exit 

ecx 
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loc 401110: 


push 
call 
pop 
test 
jz 
push 
call 
pop 


loc 401123: 


$LN28: 


$LN27: 


mov 
mov 
push 
push 
push 
call 
add 
mov 
cmp 
jnz 
push 
call 


call 
jmp 


mov 


401044 


$LN24: 


$LN14: 


mov 
mov 
mov 
push 
push 
call 
pop 
pop 


retn 


mov 


401044 


mov 
mov 
cmp 
jnz 
push 


, 


, 


, 


, 


, 


; CODE XREF: — tmainCRTStartup+C2 
1 
. cinit 
ecx 
eax, eax 
short loc 401123 
eax 
. amsg exit 
ecx 
; CODE XREF: — tmainCRTStartup+D6 
eax, envp 
dword 40AC80, eax 
eax ; envp 
argv ; argv 
argc ; argc 
main 
esp, OCh 


[ebp-var 20], eax 
[ebp+var_1C], 0 
short $LN28 


eax ; uExitCode 
$LN32 

; CODE XREF: — tmainCRTStartup+105 
__cexit 


short loc 401186 


; DATA XREF: .rdata:stru 4092D0 


eax, [ebp+ms exc.exc ptr] ; Exception filter 0 for function 


ecx, [eax] 

ecx, [ecx] 
[ebp+var_ 24], ecx 
eax 

ecx 

. XcptFilter 

ecx 

ecx 


DATA XREF: .rdata:stru 4092D0 
esp, [ebp+ms exc.old esp] ; Exception handler 0 for function 


eax, [ebp+var_ 24] 
[ebp+var_20], eax 
[ebp+var_1C], 0 

short $LN29 

eax ; int 
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call | exit 

$LN29: ; CODE XREF: tmainCRTStartup+135 
call | Cc exit 

loc 401186: ; CODE XREF: tmainCRTStartup+112 
mov [ebp+ms_exc.disabled], OFFFFFFFEh 
mov eax, [ebp+var_ 20] 
call . SEH epilog4 
retn 


Here we can see calls to GetCommandLineA() (line 62), then to setargv() (line 66) 
and setenvp() (line 74), which apparently fill the global variables argc, argv, envp. 


Finally, main() is called with these arguments (line 97). 


There are also calls to functions with self-describing names like heap init() (line 
35), ioinit() (line 54). 


The heap is indeed initialized in the CRT. If you try to use malloc() in a program 
without CRT, it will exit abnormally with the following error: 


runtime error R6030 
- CRT not initialized 


Global object initializations in C++ is also occur in the CRT before the execution of 
main(): 3.21.4 on page 712. 


The value that main() returns is passed to cexit(), or in $LN32, which in turn calls 
doexit(). 


Is it possible to get rid of the CRT? Yes, if you know what you are doing. 
The MSVC's linker has the /ENTRY option for setting an entry point. 


#include «windows.h» 


int main() 


1 
ur 


MessageBox (NULL, "hello, world", "caption", MB OK); 


Let's compile it in MSVC 2008. 


cl no crt.c user32.lib /link /entry:main 


We are getting a runnable .exe with size 2560 bytes, that has a PE header in it, 
instructions calling MessageBox, two strings in the data segment, the MessageBox 
function imported from user32.dll and nothing else. 


This works, but you cannot write WinMain with its 4 arguments instead of main(). 


To be precise, you can, but the arguments are not prepared at the moment of exe- 
cution. 
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By the way, it is possible to make the .exe even shorter by aligning the PE sections 
at less than the default 4096 bytes. 


cl no crt.c user32.lib /link /entry:main /align:16 


Linker says: 


LINK : warning LNK4108: /ALIGN specified without /DRIVER; image may not run 


We get an .exe that's 720 bytes. It can be executed in Windows 7 x86, but not in 
x64 (an error message will be shown when you try to execute it). 


With even more efforts, it is possible to make the executable even shorter, but as 
you can see, compatibility problems arise quickly. 


6.5.2 Win32 PE 


PE is an executable file format used in Windows. The difference between .exe, .dll 
and .sys is that .exe and .sys usually do not have exports, only imports. 


A DLL*%, just like any other PE-file, has an entry point (OEP) (the function DlIMain() is 
located there) but this function usually does nothing. .sys is usually a device driver. 
As of drivers, Windows requires the checksum to be present in the PE file and for it 
to be correct 1°. 


Starting at Windows Vista, a driver's files must also be signed with a digital signature. 
It will fail to load otherwise. 


Every PE file begins with tiny DOS program that prints a message like "This program 
cannot be run in DOS mode."—if you run this program in DOS or Windows 3.1 (OS-es 
which are not aware of the PE format), this message will be printed. 


Terminology 


Module—a separate file, .exe or .dll. 


Process—a program loaded into memory and currently running. Commonly con- 
sists of one .exe file and bunch of .dll files. 


Process memory—the memory a process works with. Each process has its own. 
There usually are loaded modules, memory of the stack, heap(s), etc. 


VA16—an address which is to be used in program while runtime. 


Base address (of module)—the address within the process memory at which the 
module is to be loaded. OS loader may change it, if the base address is already 
occupied by another module just loaded before. 


RVA!’—the VA-address minus the base address. 


Many addresses in PE-file tables use RVA-addresses. 


14Dynamic-Link Library 

15For example, Hiew(7.1 on page 1005) can calculate it 
16Virtual Address 

17Relative Virtual Address 
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* |AT*$—an array of addresses of imported symbols 19. 
Sometimes, the IMAGE DIRECTORY ENTRY IAT data directory points at the IAT. 
It is worth noting that IDA (as of 6.1) may allocate a pseudo-section named 
.idata for IAT, even if the IAT is a part of another section! 


* INT?°—an array of names of symbols to be imported?!. 


Base address 


The problem is that several module authors can prepare DLL files for others to use 
and it is not possible to reach an agreement which addresses is to be assigned to 
whose modules. 


So that is why if two necessary DLLs for a process have the same base address, one 
of them will be loaded at this base address, and the other—at some other free space 
in process memory, and each virtual addresses in the second DLL will be corrected. 


With MSVC the linker often generates the .exe files with a base address of 0x400000 
22 and with the code section starting at 0x401000. This means that the RVA of the 
start of the code section is 0x1000. 


DLLs are often generated by MSVC's linker with a base address of 0x10000000 2°. 


There is also another reason to load modules at various base addresses, in this case 
random ones. It is ASLR. 


A shellcode trying to get executed on a compromised system must call system func- 
tions, hence, know their addresses. 


In older OS (in Windows NT line: before Windows Vista), system DLL (like kernel32.dll, 
user32.dll) were always loaded at known addresses, and if we also recall that their 
versions rarely changed, the addresses of functions were fixed and shellcode could 
call them directly. 


In order to avoid this, the ASLR method loads your program and all modules it needs 
at random base addresses, different every time. 


ASLR support is denoted in a PE file by setting the flag 
IMAGE DLL CHARACTERISTICS DYNAMIC BASE [see Mark Russinovich, Microsoft Win- 
dows Internals]. 


Subsystem 


There is also a subsystem field, usually it is: 
e native? (.sys-driver), 


e console (console application) or 


18Import Address Table 

19 Matt Pietrek, An In-Depth Look into the Win32 Portable Executable File Format, (2002)] 
20Import Name Table 

21Matt Pietrek, An In-Depth Look into the Win32 Portable Executable File Format, (2002)] 
22The origin of this address choice is described here: MSDN 

23This can be changed by the /BASE linker option 

24Meaning, the module use Native API instead of Win32 
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* GUI (non-console). 


OS version 


A PE file also specifies the minimal Windows version it needs in order to be loadable. 


The table of version numbers stored in the PE file and corresponding Windows code- 
names is here”. 


For example, MSVC 2005 compiles .exe files for running on Windows NT4 (version 
4.00), but MSVC 2008 does not (the generated files have a version of 5.00, at least 
Windows 2000 is needed to run them). 


MSVC 2012 generates .exe files of version 6.00 by default, targeting at least Windows 
Vista. However, by changing the compiler's options?*, it is possible to force it to 
compile for Windows XP. 


Sections 


Division in sections, as it seems, is present in all executable file formats. 
It is devised in order to separate code from data, and data—from constant data. 


Either the /MAGE SCN CNT CODE or IMAGE SCN MEM EXECUTE flags will be 
set on the code section—this is executable code. 


On data section—/MAGE SCN. CNT. INITIALIZED DATA, 
IMAGE SCN MEM READ and IMAGE SCN MEM WRITE flags. 


On an empty section with uninitialized data— 
IMAGE SCN CNT UNINITIALIZED DATA, IMAGE SCN MEM READ and 
IMAGE SCN MEM WhRITE. 


On a constant data section (one that's protected from writing), the flags 
IMAGE SCN CNT INITIALIZED DATA and IMAGE SCN MEM READ can be set, 
but not IMAGE SCN MEM WhITE. A process going to crash if it tries to write to 
this section. 


Each section in PE-file may have a name, however, it is not very important. Often 
(but not always) the code section is named .text, the data section— .data, the 
constant data section — .rdata (readable data) (perhaps, . rdata means read-only- 
data). Other popular section names are: 


e .idata—imports section. IDA may create a pseudo-section named like this: 
6.5.2 on the preceding page. 


* ,edata—exports section (rare) 


* .pdata—section holding all information about exceptions in Windows NT for 
MIPS, 1A64 and x64: 6.5.3 on page 997 


e .reloc—relocs section 


?5Wikipedia 
26MSDN 
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e .bss—uninitialized data (BSS) 

e , tls—thread local storage (TLS) 

e .rsrc—resources 

* .CRT—may present in binary files compiled by ancient MSVC versions 


PE file packers/encryptors often garble section names or replace the names with 
their own. 


MSVC allows you to declare data in arbitrarily named section 2’. 


Some compilers and linkers can add a section with debugging symbols and other 
debugging information (MinGW for instance). However it is not so in latest versions 
of MSVC (separate PDB files are used there for this purpose). 


That is how a PE section is described in the file: 


typedef struct IMAGE SECTION HEADER { 
BYTE Name[IMAGE SIZEOF SHORT NAME]; 
union { 
DWORD PhysicalAddress; 
DWORD VirtualSize; 
) Misc; 
DWORD VirtualAddress; 
DWORD SizeOfRawData; 
DWORD PointerToRawData; 
DWORD PointerToRelocations; 
DWORD PointerToLinenumbers; 
WORD NumberOfRelocations; 
WORD NumberOfLinenumbers; 
DWORD Characteristics; 
) IMAGE SECTION HEADER, *PIMAGE SECTION HEADER; 


28 


A word about terminology: PointerToRawData is called "Offset" in Hiew and Virtual- 
Address is called "RVA" there. 


Data section 


Data section in file can be smaller than in memory. For example, some variables can 
be initialized, some are not. Compiler and linker will collect them all into one section, 
but the first part of it is initialized and allocated in file, while another is absent in file 
(of course, to make it smaller). VirtualSize will be equal to the size of section in 
memory, and SizeOfRawData — to size of section in file. 


IDA can show the border between initialized and not initialized parts like that: 


27MSDN 
28MSDN 
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.data:10017FFA db 0 
.data:10017FFB db 0 
.data:10017FFC db 0 
.data:10017FFD db 0 
.data:10017FFE db 0 
.data:10017FFF db 0 
.data:10018000 db ? ; 
.data:10018001 db ? ; 
.data:10018002 db ? i 
.data:10018003 db ? 4 
.data:10018004 db ? 4 
.data:10018005 db ? ; 


.rdata — read-only data section 


Strings are usually located here (because they have const char* type), other vari- 
ables marked as const, imported function names. 


See also: 3.3 on page 582. 


Relocations (relocs) 


AKA FIXUP-s (at least in Hiew). 


They are also present in almost all executable file formats ??. Exceptions are shared 
dynamic libraries compiled with PIC, or any other PIC-code. 


What are they for? 


Obviously, modules can be loaded on various base addresses, but how to deal with 
global variables, for example? They must be accessed by address. One solution is 
position-independent code (6.4.1 on page 952). But it is not always convenient. 


That is why a relocations table is present. There the addresses of points that must 
be corrected are enumerated, in case of loading at a different base address. 


For example, there is a global variable at address 0x410000 and this is how it is 
accessed: 


A1 00 00 41 00 mov eax, [000410000] 


The base address of the module is 0x400000, the RVA ofthe global variable is 0x10000. 


If the module is loaded at base address 0x500000, the real address of the global 
variable must be 0x510000. 


As we can see, the address of variable is encoded in the instruction MOV, after the 
byte OxA1. 


That is why the address of the 4 bytes after 0xA1, is written in the relocs table. 


29Even in .exe files for MS-DOS 
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If the module is loaded at a different base address, the OS loader enumerates all 
addresses in the table, 


finds each 32-bit word the address points to, subtracts the original base address 
from it (we get the RVA here), and adds the new base address to it. 


If a module is loaded at its original base address, nothing happens. 
All global variables can be treated like that. 


Relocs may have various types, however, in Windows for x86 processors, the type 
is usually 
IMAGE REL BASED HIGHLOW. 


By the way, relocs are darkened in Hiew, for example: fig.1.21. (You have to circum- 
vent these bytes during patching.) 


OllyDbg underlines the places in memory to which relocs are to be applied, for ex- 
ample: fig.1.52. 


Exports and imports 


As we all know, any executable program must use the OS's services and other DLL- 
libraries somehow. 


It can be said that functions from one module (usually DLL) must be connected some- 
how to the points of their calls in other modules (.exe-file or another DLL). 


For this, each DLL has an "exports" table, which consists of functions plus their 
addresses in a module. 


And every .exe file or DLL has "imports", a table of functions it needs for execution 
including list of DLL filenames. 


After loading the main .exe-file, the OS loader processes imports table: it loads the 
additional DLL-files, finds function names among the DLL exports and writes their 
addresses down in the IAT of the main .exe-module. 


As we can see, during loading the loader must compare a lot of function names, but 
string comparison is not a very fast procedure, so there is a support for "ordinals" or 
"hints", which are function numbers stored in the table, instead of their names. 


That is how they can be located faster when loading a DLL. Ordinals are always 
present in the "export" table. 


For example, a program using the MFC?? library usually loads mfc*.dll by ordinals, 
and in such programs there are no MFC function names in INT. 


When loading such programs in IDA, it will ask for a path to the mfc*.dll files in order 
to determine the function names. 


If you don't tell IDA the path to these DLLs, there will be mfc80 123 instead of func- 
tion names. 


30Microsoft Foundation Classes 
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Imports section 


Often a separate section is allocated for the imports table and everything related to 
it (with name like . idata), however, this is not a strict rule. 


Imports are also a confusing subject because of the terminological mess. Let's try 
to collect all information in one place. 


( IMAGE IMPORT DESCRIPTOR for kernel32 dll : 


OriginalFirst Thunk 
TimeDateStamp = 0 


16-bit hint, "Sleep" 
ForwarderChain = 0 1 1 
Name : 16-bit hint, "WriteFile" 


FirstThunk 


. | IMAGE. IMPORT. DESCRIPTOR for user32.dil | - 


OriginalFirst Thunk E | ; 
[ \ OriginalFirstThunk for user32 dil 


TimeDateStamp = 0 
ForwarderChain = 0 
Name 


FrsThunk [ OrgnatFistrhunktoruserz2a | 
| NULL IMAGE IMPORT DESCRIPTOR FirstThunk for kernel32 dl : 
| pem z FirstThunk for user32 dil i 
: |OriginalFirstThunk = 0 | | (These values are set by loader) : 

TimeDateStamp =0 #1 imp_CrealeFileA "E — 1E 
ForwarderChain = 0 #2 . imp GetFileSize 
Name = 0 #3 imp_Sleep 
FirstT hunk = 0 #4 imp_WriteFile 
PE Data Directory 
#1 (IMAGE_DIRECTORY_ENTRY_IMPORT) 1 


#5 (IMAGE. DIRECTORY. ENTRY. BASERELOC) : — — 


=J 


F 15 xx xx xx xx call __imp_GetFileSize 


IMAGE REL BASED HIGHLOW, RVA of ... 
IMAGE REL BASED HIGHLOW, RVA of ... 


IMAGE REL BASED HIGHLOW, RVA of ... : FF 25 xx xx xx xx jmp imp Sleep 
IMAGE_REL_BASED_HIGHLOW, RVA of .. iteFile: 


5 : FF 25 xx xx xx xx jmp __imp_WriteFile 
IMAGE REL BASED HIGHLOW, RVA of ... 


Figure 6.1: A scheme that unites all PE-file structures related to imports 


The main structure is the array IMAGE IMPORT DESCRIPTOR. Each element for each 
DLL being imported. 
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Each element holds the RVA address of the text string (DLL name) (Name). 


OriginalFirstThunk is the RVA address of the INT table. This is an array of RVA ad- 
dresses, each of which points to a text string with a function name. Each string is 
prefixed by a 16-bit integer ("hint")—"ordinal" of function. 


While loading, if it is possible to find a function by ordinal, then the strings compari- 
son will not occur. The array is terminated by zero. 


There is also a pointer to the IAT table named FirstThunk, it is just the RVA address 
of the place where the loader writes the addresses of the resolved functions. 


The points where the loader writes addresses are marked by IDA like this: imp CreateFileA, 
etc. 


There are at least two ways to use the addresses written by the loader. 


* The code will have instructions like ca// imp CreateFileA, and since the field 
with the address of the imported function is a global variable in some sense, the 
address of the call instruction (plus 1 or 2) is to be added to the relocs table, 
for the case when the module is loaded at a different base address. 


But, obviously, this may enlarge relocs table significantly. 
Because there are might be a lot of calls to imported functions in the module. 


Furthermore, large relocs table slows down the process of loading modules. 


For each imported function, there is only one jump allocated, using the JMP 
instruction plus a reloc to it. Such points are also called "thunks". 


All calls to the imported functions are just CALL instructions to the corresponding 
"thunk". In this case, additional relocs are not necessary because these CALL-s 
have relative addresses and do not need to be corrected. 


These two methods can be combined. 
Possible, the linker creates individual "thunk"s if there are too many calls to the func- 
tion, but not done by default. 


By the way, the array of function addresses to which FirstThunk is pointing is not 
necessary to be located in the IAT section. For example, the author of these lines 
once wrote the PE add import?! utility for adding imports to an existing .exe-file. 


Some time earlier, in the previous versions of the utility, at the place of the function 
you want to substitute with a call to another DLL, my utility wrote the following code: 


MOV EAX, [yourdll.dll!function] 
JMP EAX 


FirstThunk points to the first instruction. In other words, when loading yourdll.dll, 
the loader writes the address of the function function right in the code. 


It also worth noting that a code section is usually write-protected, so my utility adds 
the 


3lyurichev.com 
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IMAGE SCN MEM WhRITE flag for code section. Otherwise, the program to crash 
while loading with error code 5 (access denied). 


One might ask: what if | supply a program with a set of DLL files which is not sup- 
posed to change (including addresses of all DLL functions), is it possible to speed up 
the loading process? 


Yes, it is possible to write the addresses of the functions to be imported into the 
FirstThunk arrays in advance. 
The Timestamp field is present in the IMAGE IMPORT. DESCRIPTOR structure. 


If a value is present there, then the loader compares this value with the date-time 
of the DLL file. 


If the values are equal, then the loader does not do anything, and the loading of the 
process can be faster. This is called "old-style binding" ??. 


The BIND.EXE utility in Windows SDK is for this. For speeding up the loading of your 
program, Matt Pietrek in Matt Pietrek, An In-Depth Look into the Win32 Portable Exe- 
cutable File Format, (2002)]??, suggests to do the binding shortly after your program 
installation on the computer of the end user. 

PE-files packers/encryptors may also compress/encrypt imports table. 

In this case, the Windows loader, of course, will not load all necessary DLLs. 


Therefore, the packer/encryptor does this on its own, with the help of LoadLibrary() 
and the GetProcAddress() functions. 


That is why these two functions are often present in IAT in packed files. 
In the standard DLLs from the Windows installation, IAT often is located right at the 
beginning of the PE file. Supposedly, it is made so for optimization. 


While loading, the .exe file is not loaded into memory as a whole (recall huge in- 
stall programs which are started suspiciously fast), it is “mapped”, and loaded into 
memory in parts as they are accessed. 


Probably, Microsoft developers decided it will be faster. 


Resources 


Resources in a PE file are just a set of icons, pictures, text strings, dialog descriptions. 


Perhaps they were separated from the main code, so all these things could be mul- 
tilingual, and it would be simpler to pick text or picture for the language that is 
currently set in the OS. 


As a side effect, they can be edited easily and saved back to the executable file, 
even if one does not have special knowledge, by using the ResHack editor, for ex- 
ample (6.5.2 on the following page). 


32MSDN. There is also the "new-style binding". 
33Also available as http: //msdn.microsoft.com/en-us/magazine/bb985992.aspx 
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«NET 


.NET programs are not compiled into machine code but into a special bytecode. 
Strictly speaking, there is bytecode instead of the usual x86 code in the .exe file, 
however, the entry point (OEP) points to this tiny fragment of x86 code: 


jmp mscoree.dll! CorExeMain 


The .NET loader is located in mscoree.dll, which processes the PE file. 


It was so in all pre-Windows XP OSes. Starting from XP, the OS loader is able to 
detect the .NET file and run it without executing that JMP instruction ?^. 


TLS 


This section holds initialized data for the TLS(6.2 on page 944) (if needed). When a 
new thread start, its TLS data is initialized using the data from this section. 


Aside from that, the PE file specification also provides initialization of the TLS section, 
the so-called TLS callbacks. 


If they are present, they are to be called before the control is passed to the main 
entry point (OEP). 


This is used widely in the PE file packers/encryptors. 


Tools 


objdump (present in cygwin) for dumping all PE-file structures. 


Hiew(7.1 on page 1005) as editor. 


pefile—Python-library for PE-file processing ??. 


ResHack AKA Resource Hacker—resources editor?*. 


PE add import?/— simple tool for adding symbol(s) to PE executable import 
table. 


PE patcher??—simple tool for patching PE executables. 


PE search str refs??—simple tool for searching for a function in PE executables 
which use some text string. 


34MSDN 
35https://code.google.com/p/pefile/ 
36https://code.google.com/p/pefile/ 
37http://yurichev.com/PE add imports.html 
38yurichev.com 

39yurichev.com 
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Further reading 


e Daniel Pistelli—The .NET File Format ^? 


6.5.3 Windows SEH 
Let's forget about MSVC 


In Windows, the SEH is intended for exceptions handling, nevertheless, it is language- 
agnostic, not related to C++ or OOP in any way. 


Here we are going to take a look at SEH in its isolated (from C++ and MSVC exten- 
sions) form. 


Each running process has a chain of SEH handlers, each TIB has the address of the 
most recently defined handler. 


When an exception occurs (division by zero, incorrect address access, user exception 
triggered by calling the RaiseException() function), the OS finds the last handler 
in the TIB and calls it, passing exception kind and all information about the CPU state 
(register values, etc.) at the moment of the exception. 


The exception handler considering the exception, does it see something familiar? If 
so, it handles the exception. 


If not, it signals to the OS that it cannot handle it and the OS calls the next handler 
in the chain, until a handler which is able to handle the exception is be found. 


At the very end of the chain there a standard handler that shows the well-known 
dialog box, informing the user about a process crash, some technical information 
about the CPU state at the time of the crash, and offering to collect all information 
and send it to developers in Microsoft. 


crash.exe has encountered a problem and needs to 
close. We are sorry for the inconvenience. 


If you were in the middle of something, the information you were working on 
might be lost. 


Please tell Microsoft about this problem. 


We have created an error report that you can send to us. We will treat 
this report as confidential and anonymous. 


To see what data this error report contains, 


Send Error Report | Don't Send | 


Figure 6.2: Windows XP 


40http: //www.codeproject.com/Articles/12585/The-NET- File-Format 
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Error Report Contents 


Figure 6.3: Windows XP 


® crash.exe 


LE 


Figure 6.4: Windows 7 
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crash.exe has stopped working 


A problem caused the program to stop working correctly. 
Windows will close the program and notify you if a solution is 
available. 


Close program 


Figure 6.5: Windows 8.1 


Earlier, this handler was called Dr. Watson. 


By the way, some developers make their own handler that sends information about 


the program crash to themselves. It is registered with the help of SetUnhandledExceptionFilter() 


and to be called if the OS does not have any other way to handle the exception. An 
example is Oracle RDBMS— it saves huge dumps reporting all possible information 
about the CPU and memory state. 


Let's write our own primitive exception handler. This example is based on the ex- 
ample from [Matt Pietrek, A Crash Course on the Depths of Win32™ Structured 
Exception Handling, (1997)]^!. It must be compiled with the SAFESEH option: cl 
sehl.cpp /link /safeseh:no. More about SAFESEH here: MSDN. 


#include «windows.h» 
#include <stdio.h> 


DWORD new_value=1234; 


EXCEPTION DISPOSITION cdecl except handler( 
struct EXCEPTION RECORD *ExceptionRecord, 
void * EstablisherFrame, 
struct CONTEXT *ContextRecord, 
void * DispatcherContext ) 


unsigned i; 


printf ("%s\n", _ FUNCTION ); 

printf ("ExceptionRecord->ExceptionCode=0x%p\n", ExceptionRecord-»7 
V ExceptionCode) ; 

printf ("ExceptionRecord->ExceptionFlags=0x%p\n", ExceptionRecord->/ 
\ ExceptionFlags) ; 

printf ("ExceptionRecord->ExceptionAddress=0x%p1n", ExceptionRecord/ 
VS ->ExceptionAddress) ; 


if (ExceptionRecord->ExceptionCode==0xE1223344) 


{ 
printf ("That's for us\n"); 


4lAlso available as http: //www.microsoft.com/msj/0197/Exception/Exception.aspx 
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// yes, we "handled" the exception 
return ExceptionContinueExecution; 


} 
else if (ExceptionRecord->ExceptionCode==EXCEPTION ACCESS VIOLATION 
4) 
1 
printf ("ContextRecord->Eax=0x%08X\n", ContextRecord->Eax) ; 
// will it be possible to 'fix' it? 
printf ("Trying to fix wrong pointer address\n"); 
ContextRecord--Eax-(DWORD)&new value; 
// yes, we "handled" the exception 
return ExceptionContinueExecution; 
} 
else 
{ 
printf ("We do not handle this\n"); 
// someone else's problem 
return ExceptionContinueSearch; 
hi 
} 
int main() 
{ 
DWORD handler = (DWORD)except_handler; // take a pointer to our 
handler 
// install exception handler 
__asm 
// make EXCEPTION REGISTRATION 
record: 
push handler // address of handler function 
push FS: [0] // address of previous handler 
mov FS: [0], ESP // add new EXECEPTION REGISTRATION 
} 
RaiseException (0xE1223344, 0, 0, NULL); 
// now do something very bad 
int* ptr=NULL; 
int val=0; 
val=*ptr; 
printf ("val=%d\n", val); 
// deinstall exception handler 
__asm 
{ // remove our EXECEPTION REGISTRATION 
record 
mov eax, [ESP] // get pointer to previous record 
mov FS: [0], EAX // install previous record 
add esp, 8 // clean our EXECEPTION REGISTRATION 
off stack 
} 
return 0; 
} 
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The FS: segment register is pointing to the TIB in win32. 


The very first element in the TIB is a pointer to the last handler in the chain. We 
save it in the stack and store the address of our handler there. The structure is 
named EXCEPTION REGISTRATION, it is a simple singly-linked list and its elements 
are stored right in the stack. 


Listing 6.22: MSVC/VC/crt/src/exsup.inc 


EXCEPTION REGISTRATION struc 
prev dd ? 
handler dd ? 

EXCEPTION REGISTRATION ends 


So each "handler" field points to a handler and an each "prev" field points to the 
previous record in the chain of exception handlers. The last record has OxFFFFFFFF 
(-1) in the "prev" field. 


TIB Stack 


+0: except list 


handler function 


handler function 


After our handler is installed, we call RaiseException() ^. This is an user ex- 
ception. The handler checks the code. If the code is 0xE1223344, it returning 
ExceptionContinueExecution, which means that handler corrected the CPU state 
(it is usually a correction of the EIP/ESP registers) and the OS can resume the execu- 
tion of the thread. If you alter slightly the code so the handler returns ExceptionContinueSearch, 


handler function 


then the OS will call the other handlers, and it's unlikely that one who can handle it 
will be found, since no one will have any information about it (rather about its code). 
You will see the standard Windows dialog about a process crash. 


What is the difference between a system exceptions and a user one? Here are the 
system ones: 


42MSDN 
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as defined in WinBase.h as defined in ntstatus.h value 

EXCEPTION ACCESS VIOLATION STATUS ACCESS VIOLATION 0xC0000005 
EXCEPTION DATATYPE MISALIGNMENT STATUS DATATYPE MISALIGNMENT 0x80000002 
EXCEPTION BREAKPOINT STATUS BREAKPOINT 0x80000003 
EXCEPTION SINGLE STEP STATUS SINGLE STEP 0x80000004 
EXCEPTION ARRAY BOUNDS EXCEEDED STATUS ARRAY BOUNDS EXCEEDED 0xC000008C 
EXCEPTION FLT DENORMAL OPERAND STATUS FLOAT DENORMAL OPERAND 0xC000008D 
EXCEPTION_FLT_DIVIDE_BY_ZERO STATUS_FLOAT_DIVIDE_BY_ZERO 0xC000008E 
EXCEPTION_FLT_INEXACT_RESULT STATUS_FLOAT_INEXACT_RESULT 0xC000008F 
EXCEPTION_FLT_INVALID_OPERATION STATUS_FLOAT_INVALID_OPERATION 0xC0000090 
EXCEPTION FLT OVERFLOW STATUS FLOAT OVERFLOW 0xC0000091 
EXCEPTION FLT STACK CHECK STATUS FLOAT STACK CHECK 0xC0000092 
EXCEPTION FLT UNDERFLOW STATUS FLOAT UNDERFLOW 0xC0000093 
EXCEPTION INT DIVIDE BY ZERO STATUS INTEGER DIVIDE BY ZERO 0xC0000094 
EXCEPTION INT OVERFLOW STATUS INTEGER OVERFLOW 0xC0000095 
EXCEPTION PRIV INSTRUCTION STATUS PRIVILEGED INSTRUCTION 0xC0000096 
EXCEPTION IN PAGE ERROR STATUS IN PAGE ERROR 0xC0000006 
EXCEPTION ILLEGAL INSTRUCTION STATUS ILLEGAL INSTRUCTION 0xC000001D 
EXCEPTION NONCONTINUABLE EXCEPTION | STATUS NONCONTINUABLE EXCEPTION | 0xC0000025 
EXCEPTION STACK OVERFLOW STATUS STACK OVERFLOW 0xC0O0000FD 
EXCEPTION INVALID DISPOSITION STATUS INVALID DISPOSITION 0xC0000026 
EXCEPTION GUARD PAGE STATUS GUARD PAGE VIOLATION 0x80000001 
EXCEPTION INVALID HANDLE STATUS INVALID HANDLE 0xC0000008 
EXCEPTION POSSIBLE DEADLOCK STATUS POSSIBLE DEADLOCK 0xC0000194 
CONTROL C EXIT STATUS CONTROL C EXIT 0xC000013A 


That is how the code is defined: 


31 29 28 27 


16 15 


S UlO Facility code 


Error code 


S is a basic status code: 11—error; 10—warning; 01—informational; 00—success. 


U—whether the code is user code. 


That is why we chose 0xE1223344—E;s (11102) OxE (1110b) means that it is 1) user 


exception; 2) error. 


But to be honest, this example works fine without these high bits. 


Then we try to read a value from memory at address 0. 


Of course, there is nothing at this address in win32, so an exception is raised. 


The very first handler is to be called—yours, and it will know about it first, by checking 
the code if it's equal to the EXCEPTION ACCESS VIOLATION constant. 


The code that's reading from memory at address O is looks like this: 


Listing 6.23: MSVC 2010 


xor 


eax, eax 
mov eax, DWORD PTR [eax] 
push eax 

push OFFSET msg 


, 


; exception will occur here 
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call | printf 
add esp, 8 


Will it be possible to fix this error "on the fly" and to continue with program execution? 


Yes, our exception handler can fix the EAX value and let the OS execute this instruc- 
tion once again. So that is what we do. printf() prints 1234, because after the 
execution of our handler EAX is not 0, but contains the address of the global variable 
new value. The execution will resume. 


That is what is going on: the memory manager in the CPU signals about an error, the 
CPU suspends the thread, finds the exception handler in the Windows kernel, which, 
in turn, starts to call all handlers in the SEH chain, one by one. 


We use MSVC 2010 here, but of course, there is no any guarantee that EAX will be 
used for this pointer. 


This address replacement trick is showy, and we considering it here as an illustration 
of SEH's internals. Nevertheless, it's hard to recall any case where it is used for "on- 
the-fly" error fixing. 


Why SEH-related records are stored right in the stack instead of some other place? 


Supposedly because the OS is not needing to care about freeing this information, 
these records are simply disposed when the function finishes its execution. This is 
somewhat like alloca(): (1.9.2 on page 47). 


Now let's get back to MSVC 


Supposedly, Microsoft programmers needed exceptions in C, but not in C++ (for 
use in Windows NT kernel, which is written in C), so they added a non-standard C 
extension to MSVC^. It is not related to C++ PL exceptions. 


. try 
1 


} 


. except(filter code) 


handler code 


"Finally" block may be instead of handler code: 


. try 
1 


} 
. finally 
t 


43MSDN 
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E 


The filter code is an expression, telling whether this handler code corresponds to the 
exception raised. 


If your code is too big and cannot fit into one expression, a separate filter function 
can be defined. 


There are a lot of such constructs in the Windows kernel. Here are a couple of exam- 
ples from there (WRK): 


Listing 6.24: WRK-v1.2/base/ntos/ob/obwait.c 


try { 


KeReleaseMutant( (PKMUTANT)SignalObject, 
MUTANT INCREMENT, 
FALSE, 
TRUE ); 


} except((GetExceptionCode () == STATUS ABANDONED | | 
GetExceptionCode () == STATUS MUTANT NOT OWNED)? 
EXCEPTION EXECUTE HANDLER : 
EXCEPTION CONTINUE SEARCH) { 
Status = GetExceptionCode(); 


goto WaitExit; 


Listing 6.25: WRKv1.2/base/ntos/cache/cachesub.c 


try { 


RtlCopyBytes( (PVOID) ((PCHAR)CacheBuffer + PageOffset), 
UserBuf fer, 
MorePages ? 
(PAGE SIZE - PageOffset) 
(ReceivedLength - PageOffset) ); 


) except( CcCopyReadExceptionFilter( GetExceptionInformation(), 
&Status ) ) 1 


Here is also a filter code example: 


Listing 6.26: WRK-v1.2/base/ntos/cache/copysup.c 


LONG 

CcCopyReadExceptionFilter ( 
IN PEXCEPTION POINTERS ExceptionPointer, 
IN PNTSTATUS ExceptionCode 
) 


[++ 
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Routine Description: 
This routine serves as an exception filter and has the special job of 
extracting the "real" I/O error when Mm raises STATUS IN PAGE ERROR 
beneath us. 


Arguments: 


ExceptionPointer - A pointer to the exception record that contains 
the real Io Status. 


ExceptionCode - A pointer to an NTSTATUS that is to receive the real 
status. 


Return Value: 


EXCEPTION EXECUTE HANDLER 


--*/ 

{ 
*ExceptionCode = ExceptionPointer->ExceptionRecord->ExceptionCode; 
if ( (*ExceptionCode == STATUS IN PAGE ERROR) && 

(ExceptionPointer->ExceptionRecord->NumberParameters >= 3) ) { 
*ExceptionCode = (NTSTATUS) ExceptionPointer->ExceptionRecord->/ 

V ExceptionInformation[2]; 
} 
ASSERT( !NT SUCCESS(*ExceptionCode) ); 
return EXCEPTION EXECUTE HANDLER; 

} 


Internally, SEH is an extension of the OS-supported exceptions. But the handler 
function is except handler3 (for SEH3) or except handler4 (for SEH4). 


The code of this handler is MSVC-related, it is located in its libraries, or in msvcr*.dll. 
It is very important to know that SEH is a MSVC thing. 


Other win32-compilers may offer something completely different. 


SEH3 


SEH3has except handler3asahandler function, and extends the EXCEPTION REGISTRATION 


table, adding a pointer to the scope table and previous try level variable. SEH4 ex- 
tends the scope table by 4 values for buffer overflow protection. 


The scope table is a table that consists of pointers to the filter and handler code 
blocks, for each nested level of try/except. 
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information about 
first try/except 
block 


information about 
second try/except 
block 


information about 
third try/except 
block 


TIB Stack 


+0: except list 
scope table 


OxFFFFFFFF (-1) 
filter function 


handler/finally function 


scope table 
filter function 
A : previous try level 
handler/finally function 


~ 
- hoe 
filter function 


handler function 


handler function 


except handler3 


handler/finally function 


.. more entries ... 


Again, it is very important to understand that the OS takes care only of the prev/han- 
dle fields, and nothing more. 

It is the job of the except handler3 function to read the other fields and scope 
table, and decide which handler to execute and when. 


The source code of the except handler3 function is closed. 


However, Sanos OS, which has a win32 compatibility layer, has the same functions 
reimplemented, which are somewhat equivalent to those in Windows ^^. Another 
reimplementation is present in Wine* and ReactOS*°. 


If the filter pointer is NULL, the handler pointer is the pointer to the finally code 


block. 


^ https://code.google.com/p/sanos/source/browse/src/win32/msvcrt/except.c 


45GitHub 


46http://doxygen. reactos.org/d4/df2/lib 2sdk 2crt 2except 2except 8c source.html 
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During execution, the previous try level value inthe stack changes, so except handler3 
can get information about the current level of nestedness, in order to know which 
Scope table entry to use. 


SEH3: one try/except block example 


#include <stdio.h> 
#include <windows.h> 
#include <excpt.h> 


int main() 
{ 
int* p = NULL; 
. try 
1 
printf("hello #1!\n"); 
*p = 13; // causes an access violation exception; 
printf("hello #2!\n"); 
} 


_ except(GetExceptionCode()--EXCEPTION ACCESS VIOLATION ? 
EXCEPTION EXECUTE HANDLER : EXCEPTION CONTINUE SEARCH) 


{ 
printf("access violation, can't recover\n"); 

} 

} 
Listing 6.27: MSVC 2003 

$5G74605 DB ‘hello #1!', OaH, OOH 
$SG74606 DB ‘hello #2!', OaH, OOH 
$5G74608 DB ‘access violation, can''t recover', OaH, 00H 
_DATA ENDS 
; scope table: 
CONST SEGMENT 
$T74622 DD OffffffffH ; previous try level 


DD FLAT:$L74617 ; filter 
DD FLAT:$L74618 ; handler 


CONST ENDS 

_ TEXT SEGMENT 

$174621 = -32 ; size 4 

_p$ = -28 ; Size 4 

. S$SEHRec$ = -24 ; size = 24 
main PROC NEAR 


push ebp 

mov ebp, esp 

push - ; previous try level 
push OFFSET FLAT:$T74622 ; scope table 

push OFFSET FLAT: except handler3 ; handler 

mov eax, DWORD PTR fs: except list 

push eax ; prev 
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mov DWORD PTR fs: except list, esp 
add esp, -16 
; 3 registers to be saved: 
push ebx 
push esi 
push edi 
mov DWORD PTR  $SEHRec$[ebp], esp 
mov DWORD PTR p$[ebp], 0 
mov DWORD PTR _ $SEHRec$[ebp+20], © ; previous try level 
push OFFSET FLAT:$SG74605 ; ‘hello #1!' 
call printf 
add esp, 4 
mov eax, DWORD PTR _p$[ebp] 
mov DWORD PTR [eax], 13 
push OFFSET FLAT:$SG74606 ; ‘hello #2!' 
call printf 
add esp, 4 
mov DWORD PTR _ $SEHRec$[ebp+20], -1 ; previous try level 
jmp SHORT $L74616 
; filter code: 
$L74617: 
$L74627: 
mov ecx, DWORD PTR _ $SEHRec$[ebp+4] 
mov edx, DWORD PTR [ecx] 
mov eax, DWORD PTR [edx] 
mov DWORD PTR $T74621[ebp], eax 
mov eax, DWORD PTR $T74621[ebp] 
sub eax, -1073741819; c0000005H 
neg eax 
sbb eax, eax 
inc eax 
$L74619: 
$L74626: 
ret 0 


; handler code: 


$L74618: 
mov 
push 
call 
add 
mov 
to -1 

$L74616: 
xor 
mov 
mov 
pop 
pop 
pop 
mov 
pop 
ret 


esp, DWORD PTR $SEHRec$[ebp] 

OFFSET FLAT:$SG74608 ; 'access violation, can''t recover' 

| printf 

esp, 4 

DWORD PTR _ $SEHRec$[ebp+20], -1 ; setting previous try level back 


eax, eax 
ecx, DWORD PTR _ $SEHRec$[ebp+8] 
DWORD PTR fs: except list, ecx 
edi 

esi 

ebx 

esp, ebp 

ebp 

0 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


985 


main ENDP 
TEXT ENDS 
END 


Here we see how the SEH frame is constructed in the stack. The scope table is 
located in the CONST segment—indeed, these fields are not to be changed. An in- 
teresting thing is how the previous try level variable has changed. The initial value 
is OXFFFFFFFF (-1). The moment when the body of the try statement is opened is 
marked with an instruction that writes 0 to the variable. The moment when the body 
of the try statement is closed, -1 is written back to it. We also see the addresses of 
filter and handler code. 


Thus we can easily see the structure of the try/except constructs in the function. 
Since the SEH setup code in the function prologue may be shared between many 


functions, sometimes the compiler inserts a call to the SEH prolog() function in the 
prologue, which does just that. 


The SEH cleanup code is in the SEH epilog() function. 


Let's try to run this example in tracer: 


tracer.exe -1:2.exe --dump-seh 


Listing 6.28: tracer.exe output 


EXCEPTION ACCESS VIOLATION at 2.exe!main+0x44 (0x401054) 2 
V ExceptionInformation[0]=1 
EAX=0x00000000 EBX=0x7efde000 ECX=0x0040cbc8 EDX-0x0008e3c8 
ESI=0x00001db1 EDI=0x00000000 EBP=0x0018feac ESP=0x0018fe80 
EIP-0x00401054 
FLAGS-AF IF RF 
* SEH frame at 0x18fe9c prev=0x18ff78 handler=0x401204 (2.exe! 7 
& except handler3) 
SEH3 frame. previous trylevel=0 
scopetable entry[0]. previous try level=-1, filter=0x401070 (2.exe!main+02 
S X60) handler=0x401088 (2.exe!main+0x78) 
* SEH frame at 0x18ff78 prev=0x18ffc4 handler=0x401204 (2.exe! 7 
V except handler3) 
SEH3 frame. previous trylevel=0 
scopetable entry[0]. previous try level=-1, filter=0x401531 (2.exe!/ 
y mainCRTStartup+0x18d) handler=0x401545 (2.exe!mainCRTStartup+0x1lal) 
* SEH frame at 0x18ffc4 prev=0x18ffe4 handler=0x771f71f5 (ntdll.dll! 7 
& except_handler4) 
SEH4 frame. previous trylevel=0 
SEH4 header: GSCookie0ffset=0xfffffffe GSCookieXOROffset-0x0 
EHCookie0ffset=0xffffffcc EHCookieXOROffset-0x0 
scopetable entry[0]. previous try level=-2, filter=0x771f74d0 (ntdll.dll!^ 
$ X safe se handler _table+0x20) handler=0x771f90eb (ntdll.dll!^ 
S _TppTerminateProcess@4+0x43 ) 
* SEH frame at 0x18ffe4 prev=0xffffffff handler=0x77247428 (ntdll.dll! 7 
\ FinalExceptionHandler(16) 
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We see that the SEH chain consists of 4 handlers. 


The first two are located in our example. Two? But we made only one? Yes, another 

one has been set up in the CRT function mainCRTStartup(), and as it seems that 
it handles at least FPU exceptions. Its source code can be found in the MSVC instal- 
lation: crt/src/winxfltr.c. 


The third is the SEH4 one in ntdll.dll, and the fourth handler is not MSVC-related 
and is located in ntdll.dll, and has a self-describing function name. 


As you can see, there are 3 types of handlers in one chain: 


one is not related to MSVC at all (the last one) and two MSVC-related: SEH3 and 
SEH4. 


SEH3: two try/except blocks example 


#include <stdio.h> 
#include <windows .h> 
#include <excpt.h> 


int filter user exceptions (unsigned int code, struct EXCEPTION POINTERS *2 


V ep) 
1 
printf("in filter. code=0x%08X\n", code); 
if (code == 0x112233) 
1 
printf("yes, that is our exception\n"); 
return EXCEPTION EXECUTE HANDLER; 
h 
else 
1 
printf("not our exception Win"); 
return EXCEPTION CONTINUE SEARCH; 
$; 
} 
int main() 
{ 
int* p = NULL; 
. try 
1 
. try 
1 
printf ("hello!\n"); 
RaiseException (0x112233, 0, 0, NULL); 
printf ("0x112233 raised. now let's crash\n"); 
*p = 13; // causes an access violation exception; 
} 


_ except (GetExceptionCode()==EXCEPTION ACCESS VIOLATION ? 
EXCEPTION EXECUTE HANDLER : EXCEPTION CONTINUE SEARCH) 
{ 


printf("access violation, can't recover\n"); 
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) 


_ except(filter user exceptions(GetExceptionCode(), Y 
S GetExceptionInformation())) 


1 
// the filter user exceptions() function answering to the question 
// "is this exception belongs to this block?" 
// if yes, do the follow: 
printf("user exception caught\n"); 
} 


Now there are two try blocks. So the scope table now has two entries, one for each 
block. Previous try level changes as execution flow enters or exits the try block. 


Listing 6.29: MSVC 2003 


$SG74606 DB ‘in filter. code=0x%08X', OaH, OOH 
$5G74608 DB ‘yes, that is our exception’, OaH, 00H 
$SG74610 DB ‘not our exception', OaH, 00H 
$5G74617 DB 'hello!', 0aH, 00H 
$5G74619 DB '0x112233 raised. now let''s crash', OaH, OOH 
$5G74621 DB ‘access violation, can''t recover', OaH, OOH 
$SG74623 DB ‘user exception caught', 0aH, 00H 
_code$ = 8 ; size = 4 
_ep$ = 12 ; size = 4 
filter user exceptions PROC NEAR 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR  code$[ebp] 
push eax 


push OFFSET FLAT:$SG74606 ; ‘in filter. code=0x%08X' 
call printf 

add esp, 8 

cmp DWORD PTR code$[ebp], 1122867; 00112233H 

jne SHORT $L74607 

push OFFSET FLAT:$SG74608 ; 'yes, that is our exception' 
call printf 

add esp, 4 


mov eax, 1 
jmp SHORT $L74605 
$L74607: 


push OFFSET FLAT:$SG74610 ; 'not our exception' 
call printf 
add esp, 4 


xor eax, eax 
$L74605: 

pop ebp 

ret 0 


filter user exceptions ENDP 


; Scope table: 
CONST SEGMENT 
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$174644 


CONST 


$T74643 
$T74642 
_p$ = -28 
.. $SEHRec 
main 
push 
mov 
push 
push 
push 
mov 
push 
mov 
add 
push 
push 
push 
mov 
mov 
mov 


DD OffffffffH ; previous try level for outer block 
DD FLAT:$L74634 ; outer block filter 
DD FLAT:$L74635 outer block handler 
DD 00H ; previous try level for inner block 
DD FLAT:$L74638 inner block filter 
DD FLAT:$L74639 inner block handler 


ENDS 
-36 ; size = 4 
-32 ; size = 4 
; size = 4 
$ = -24 ; size = 24 
PROC NEAR 
ebp 
ebp, esp 


-1 ; previous try level 

OFFSET FLAT:$T74644 

OFFSET FLAT: except handler3 
eax, DWORD PTR fs: except list 
eax 

DWORD PTR fs: except list, esp 
esp, -20 

ebx 

esi 

edi 

DWORD PTR  $SEHRec$[ebp], esp 
DWORD PTR p$[ebp], 0 

DWORD PTR _ $SEHRec$[ebp+20], © ; outer try block entered. set 


previous try level to 0 


mov 


DWORD PTR — $SEHRec$[ebp+20], 1 ; inner try block entered. set 


previous try level to 1 


push 
call 
add 
push 
push 
push 
push 
call 
push 
call 
add 
mov 
mov 
mov 


OFFSET FLAT:$SG74617 ; 'hello!' 

| printf 

esp, 4 

0 

0 

0 

1122867 ; 00112233H 

DWORD PTR imp RaiseExceptionQ16 

OFFSET FLAT:$SG74619 ; '0x112233 raised. now let''s crash' 
| printf 

esp, 4 

eax, DWORD PTR p$[ebp] 

DWORD PTR [eax], 13 

DWORD PTR  $SEHRec$[ebp420], © ; inner try block exited. set 


previous try level back to 0 


jmp 


; inner b 

$L74638: 

$L74650: 
mov 
mov 
mov 


SHORT $L74615 
lock filter: 
ecx, DWORD PTR $SEHRec$[ebp*4] 


edx, DWORD PTR [ecx] 
eax, DWORD PTR [edx] 
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mov DWORD PTR $T74643[ebp], eax 
mov eax, DWORD PTR $T74643[ebp] 
sub eax, -1073741819; c0000005H 


neg eax 
sbb eax, eax 
inc eax 

$L74640: 

$L74648: 
ret 0 


; inner block handler: 
$L74639: 
mov esp, DWORD PTR $SEHRec$[ebp] 


push OFFSET FLAT:$SG74621 ; 'access violation, can''t recover' 


call | printf 
add esp, 4 


mov DWORD PTR  $SEHRec$[ebp420], © ; inner try block exited. set 


previous try level back to 0 


$L74615: 


mov DWORD PTR  $SEHRec$[ebp-420], -1 ; outer try block exited, set 


previous try level back to -1 
jmp SHORT $L74633 


; outer block filter: 
$L74634: 
$L74651: 
mov ecx, DWORD PTR _ $SEHRec$[ebp+4] 
mov edx, DWORD PTR [ecx] 
mov eax, DWORD PTR [edx] 
mov DWORD PTR $T74642[ebp], eax 
mov ecx, DWORD PTR _ $SEHRec$[ebp+4] 


push ecx 
mov edx, DWORD PTR $T74642[ebp] 
push edx 
call | filter user exceptions 
add esp, 8 

$L74636: 

$L74649: 
ret 0 


; outer block handler: 
$L74635: 
mov esp, DWORD PTR $SEHRec$[ebp] 
push OFFSET FLAT:$5G74623 ; ‘user exception caught' 
call printf 
add esp, 4 


mov DWORD PTR _ $SEHRec$[ebp+20]1, -1 ; both try blocks exited. set 


previous try level back to -1 
$L74633: 


xor eax, eax 

mov ecx, DWORD PTR _ $SEHRec$[ebp+8] 
mov DWORD PTR fs: except list, ecx 
pop edi 
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pop esi 
pop ebx 
mov esp, ebp 
pop ebp 
ret 0 
main ENDP 


If we set a breakpoint on the printf() function, which is called from the handler, 
we can also see how yet another SEH handler is added. 


Perhaps it's another machinery inside the SEH handling process. Here we also see 
our scope table consisting of 2 entries. 


tracer.exe -1:3.exe bpx=3.exe!printf --dump-seh 


Listing 6.30: tracer.exe output 


(0) 3.exe! printf 
EAX=0x0000001b EBX=0x00000000 ECX=0x0040cc58 EDX-0x0008e3c8 
EST=0x00000000 EDI=0x00000000 EBP=0x0018f840 ESP-0x0018f838 
EIP=0x004011b6 
FLAGS=PF ZF IF 
* SEH frame at 0x18f88c prev=0x18fe9c handler=0x771db4ad (ntdll.dll!^? 
V ExecuteHandler2@20+0x3a) 
* SEH frame at 0x18fe9c prev=0x18ff78 handlerz0x4012e0 (3.exe! 7 
& except handler3) 
SEH3 frame. previous trylevel-1 
scopetable entry[0]. previous try level=-1, filter=0x401120 (3.exe!main+07 
V xb0) handler=0x40113b (3.exe!main+0xcb) 
scopetable entry[1]. previous try level=0, filter=0x4010e8 (3.exe!main-40x787 
y ) handler=0x401100 (3.exe!main+0x90) 
* SEH frame at 0x18ff78 prev=0x18ffc4 handlerz0x4012e0 (3.exe! 7 
V except handler3) 
SEH3 frame. previous trylevel=0 
scopetable entry[0]. previous try level--1, filter=0x40160d (3.exe! 7 
y mainCRTStartup+0x18d) handler=0x401621 (3.exe!mainCRTStartup+0xlal) 
* SEH frame at 0x18ffc4 prev=0x18ffe4 handler=0x771f71f5 (ntdll.dll! 2 
& — except handler4) 
SEH4 frame. previous trylevel=0 
SEH4 header: GSCookie0ffset=0xfffffffe GSCookieXOROf fset=0x0 
EHCookie0ffset=0xffffffcc EHCookieXOROf fset=0x0 
scopetable entry[0]. previous try level=-2, filter=0x771f74d0 (ntdll.dll! 2 
$ _safe_se handler table+0x20) handler=0x771f90eb (ntdll.dll!v 
S _TppTerminateProcess@4+0x43 ) 
* SEH frame at 0x18ffe4 prev=0xffffffff handler=0x77247428 (ntdll.dll! 7 
\ FinalExceptionHandler(16) 


SEH4 


During a buffer overflow (1.26.2 on page 340) attack, the address of the scope table 
can be rewritten, so starting from MSVC 2005, SEH3 was upgraded to SEH4 in order 
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to have buffer overflow protection. The pointer to the scope table is now xored with 
a security cookie. The scope table was extended to have a header consisting of two 
pointers to security cookies. 


Each element has an offset inside the stack of another value: the address of the 
stack frame (EBP) xored with the security cookie, placed in the stack. 


This value will be read during exception handling and checked for correctness. The 
security cookie in the stack is random each time, so hopefully a remote attacker 
can't predict it. 


The initial previous try level is -2 in SEH4 instead of -1. 
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TIB Stack 


+0: except list 


scope table 


GS Cookie Offset 

GS Cookie XOR Offset 

EH Cookie Offset 
scope table 

OxFFFFFFFF (-1) esecurity cookie 

information about previous try level 

first try/except filter function 


block 


m 
handler/finally function 


EBPesecurity_cookig 
second try/except filter function 
handler/finally function 


information about 
block 


information about 


handler/finally function 


.. more entries ... 


Here are both examples compiled in MSVC 2012 with SEH4: 
Listing 6.31: MSVC 2012: one try block example 


$SG85485 DB ‘hello Z1!', OaH, 00H 
$SG85486 DB ‘hello #2!', OaH, 00H 
$SG85488 DB ‘access violation, can''t recover', OaH, 00H 
; scope table: 
xdata$x SEGMENT 
. sehtable$ main DD OfffffffeH ; GS Cookie Offset 
DD 00H ; GS Cookie XOR Offset 
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DD OffffffccH ; EH Cookie Offset 
DD 00H ; EH Cookie XOR Offset 
DD OfffffffeH ; previous try level 
DD FLAT:$LN12Qmain ; filter 
DD FLAT:$LN8Gmain  ; handler 
xdata$x ENDS 
$T2 = -36 ; size = 4 
_p$ = -32 ; size = 4 
tv68 = -28 ; size = 4 
. $SEHRec$ = -24 ; size = 24 
_Main PROC 
push ebp 
mov ebp, esp 
push -2 
push OFFSET  sehtable$ main 
push OFFSET except handler4 
mov eax, DWORD PTR fs:0 
push eax 
add esp, -20 
push ebx 
push esi 
push edi 
mov eax, DWORD PTR security cookie 
xor DWORD PTR _ $SEHRec$[ebp+16], eax ; xored pointer to scope table 
xor eax, ebp 
push eax ; ebp ^ security cookie 
lea eax, DWORD PTR _ $SEHRec$[ebp+8] ; 
pointer to VC_EXCEPTION REGISTRATION RECORD 
mov DWORD PTR fs:0, eax 
mov DWORD PTR $SEHRec$[ebp], esp 
mov DWORD PTR p$[ebp], 0 
mov DWORD PTR _ $SEHRec$[ebp+20], © ; previous try level 
push OFFSET $SG85485 ; ‘hello +1!' 
call printf 
add esp, 4 
mov eax, DWORD PTR _p$[ebp] 
mov DWORD PTR [eax], 13 
push OFFSET $SG85486 ; ‘hello #2!' 
call printf 
add esp, 4 
mov DWORD PTR _ $SEHRec$[ebp+20], -2 ; previous try level 
jmp SHORT $LN6@main 
; filter: 
$LN7@main: 
$LN12@main: 
mov ecx, DWORD PTR _ $SEHRec$[ebp+4] 
mov edx, DWORD PTR [ecx] 
mov eax, DWORD PTR [edx] 
mov DWORD PTR $T2[ebp], eax 
cmp DWORD PTR $T2[ebp], -1073741819 ; c0000005H 
jne SHORT $LN4@main 
mov DWORD PTR tv68[ebp], 1 
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jmp SHORT $LN5@main 
$LN4@main: 
mov DWORD PTR tv68[ebp], 0 
$LN5@main: 
mov eax, DWORD PTR tv68[ebp] 
$LN9@main: 
$LN11@main: 
ret 0 
; handler: 
$LN8@main: 
mov esp, DWORD PTR $SEHRec$[ebp] 
push OFFSET $5G85488 ; ‘access violation, can''t recover' 
call _ printf 
add esp, 4 
mov DWORD PTR _ $SEHRec$[ebp+20], -2 ; previous try level 
$LN6@main: 
xor eax, eax 
mov ecx, DWORD PTR _ $SEHRec$[ebp+8] 
mov DWORD PTR fs:0, ecx 
pop ecx 
pop edi 
pop esi 
pop ebx 
mov esp, ebp 
pop ebp 
ret 0 
main ENDP 
Listing 6.32: MSVC 2012: two try blocks example 
$5G85486 DB ‘in filter. code=0x%08X', OaH, OOH 
$5G85488 DB 'yes, that is our exception', OaH, 00H 
$5G85490 DB ‘not our exception', OaH, 00H 
$5G85497 DB 'hello!', OaH, OOH 
$5G85499 DB '0x112233 raised. now let''s crash', OaH, OOH 
$5G85501 DB ‘access violation, can''t recover', OaH, 00H 
$5G85503 DB ‘user exception caught', OaH, 00H 
xdata$x SEGMENT 
. sehtable$ main DD OfffffffeH ; GS Cookie Offset 
DD 00H ; GS Cookie XOR Offset 
DD Of fffffc8H ; EH Cookie Offset 
DD 00H ; EH Cookie Offset 
DD OfffffffeH ; previous try level for outer block 
DD FLAT:$LN19@main ; outer block filter 
DD FLAT:$LN9Gmain ; outer block handler 
DD 00H ; previous try level for inner block 
DD FLAT:$LN186main ; inner block filter 
DD FLAT:$LN13@main ; inner block handler 
xdata$x ENDS 
$T2 = -40 ; size = 4 
$T3 = -36 ; size = 4 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


995 


_p$ = -32 ; size = 4 
tv72 = -28 ; size = 4 
. $SEHRec$ = -24 ; size = 24 
_main PROC 
push ebp 
mov ebp, esp 
push -2 ; initial previous try level 
push OFFSET _ sehtable$ main 
push OFFSET except handler4 
mov eax, DWORD PTR fs:0 
push eax ; prev 
add esp, -24 
push ebx 
push esi 
push edi 
mov eax, DWORD PTR security cookie 
xor DWORD PTR _ $SEHRec$[ebp+16], eax 
table 
xor eax, ebp 
push eax 
lea eax, DWORD PTR _ $SEHRec$[ebp+8] 


pointer to VC EXCEPTION REGISTRATION RECORD 


mov 
mov 
mov 
mov 
setting 
mov 
setting 
push 
call 
add 
push 
push 
push 
push 
call 
push 
call 
add 
mov 
mov 
mov 


jmp 


DWORD PTR fs:0, eax 
DWORD PTR — $SEHRec$[ebp], esp 
DWORD PTR p$[ebp], 0 


; xored pointer to scope 


; ebp ^ security cookie 


DWORD PTR _ $SEHRec$[ebp+20], © ; entering outer try block, 


previous try level=0 


DWORD PTR _ $SEHRec$[ebp+20], 1 ; entering inner try block, 


previous try level=1 

OFFSET $SG85497 ; 'hello!' 

| printf 

esp, 4 

0 

0 

0 

1122867 ; 00112233H 

DWORD PTR imp RaiseExceptionQ16 
OFFSET $5G85499 ; '0x112233 raised. now let''s crash' 
| printf 

esp, 4 


eax, DWORD PTR _p$[ebp] 
DWORD PTR [eax], 13 


DWORD PTR _ $SEHRec$[ebp+20], © ; exiting inner try block, set 
previous try level back to 0 


SHORT $LN2@main 


; inner block filter: 


$LN12@main: 

$LN18@main: 
mov 
mov 
mov 
mov 
cmp 
jne 


ecx, DWORD PTR  $SEHRec$[ebp+4] 
edx, DWORD PTR [ecx] 

eax, DWORD PTR [edx] 

DWORD PTR $T3[ebp], eax 


DWORD PTR $T3[ebp], -1073741819 ; c0000005H 


SHORT $LN5@main 
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mov DWORD PTR tv72[ebp], 1 

jmp SHORT $LN6@main 
$LN5@main: 

mov DWORD PTR tv72[ebp], 0 
$LN6@main: 

mov eax, DWORD PTR tv72[ebp] 
$LN14@main: 
$LN16@main: 

ret 0 


; inner block handler: 
$LN13@main: 
mov esp, DWORD PTR _ $SEHRec$[ebp] 
push OFFSET $SG85501 ; ‘access violation, can''t recover' 
call _ printf 
add esp, 4 
mov DWORD PTR _ $SEHRec$[ebp+20], © ; exiting inner try block, setting 
previous try level back to 0 
$LN2@main: 
mov DWORD PTR _ $SEHRec$[ebp+20], -2 ; exiting both blocks, setting 
previous try level back to -2 
jmp SHORT $LN7@main 


; outer block filter: 
$LN8@main: 
$LN19@main: 
mov ecx, DWORD PTR _ $SEHRec$[ebp+4] 
mov edx, DWORD PTR [ecx] 
mov eax, DWORD PTR [edx] 
mov DWORD PTR $T2[ebp], eax 
mov ecx, DWORD PTR _ $SEHRec$[ebp+4] 


push ecx 
mov edx, DWORD PTR $T2[ebp] 
push edx 
call | filter user exceptions 
add esp, 8 

$LN10@main: 

$LN17@main: 
ret 0 


; outer block handler: 
$LN9@main: 
mov esp, DWORD PTR $SEHRec$[ebp] 
push OFFSET $5G85503 ; ‘user exception caught’ 
call printf 
add esp, 4 
mov DWORD PTR _ $SEHRec$[ebp+20], -2 ; exiting both blocks, setting 
previous try level back to -2 
$LN7@main: 
xor eax, eax 
mov ecx, DWORD PTR _ $SEHRec$[ebp+8] 
mov DWORD PTR fs:0, ecx 
pop ecx 
pop edi 
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pop esi 
pop ebx 
mov esp, ebp 
pop ebp 
ret 0 
main ENDP 
_code$ = 8 ; size = 4 
_ep$ = 12 ; size = 4 
filter user exceptions PROC 
push ebp 
mov ebp, esp 
mov eax, DWORD PTR  code$[ebp] 
push eax 


push OFFSET $SG85486 ; ‘in filter. code=0x%08X' 
call printf 
add esp, 8 
cmp DWORD PTR code$[ebp], 1122867 ; 00112233H 
jne SHORT $LN2@filter_use 
push OFFSET $SG85488 ; ‘yes, that is our exception' 
call printf 
add esp, 4 
mov eax, 1 
jmp SHORT $LN3@filter_use 
jmp SHORT $LN3@filter_use 
$LN2@filter_use: 
push OFFSET $SG85490 ; ‘not our exception' 
call printf 
add esp, 4 


xor eax, eax 
$LN3eGfilter use: 
pop ebp 
ret 0 


filter user exceptions ENDP 


Here is the meaning of the cookies: Cookie Offset is the difference between the 
address of the saved EBP value in the stack and the EBP @ security cookie value 
in the stack. Cookie XOR Offset is an additional difference between the EBP e 
security cookie value and what is stored in the stack. 


If this equation is not true, the process is to halt due to stack corruption: 


security cookie 6 (Cookie X ORO f f set + address of saved EBP) == 
stack|address of saved EBP + CookieO f f set] 


If Cookie Offset is -2, this implies that it is not present. 


Windows x64 


As you might think, it is not very fast to set up the SEH frame at each function 
prologue. Another performance problem is changing the previous try level value 
many times during the function's execution. 
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So things are changed completely in x64: now all pointers to try blocks, filter and 
handler functions are stored in another PE segment .pdata, and from there the OS's 
exception handler takes all the information. 


Here are the two examples from the previous section compiled for x64: 


Listing 6.33: MSVC 2012 


$SG86276 DB ‘hello #1!', OaH, 00H 
$SG86277 DB ‘hello #2!', OaH, 00H 
$SG86279 DB ‘access violation, can''t recover', OaH, 00H 


pdata SEGMENT 
$pdata$main DD  imagerel $LN9 


DD imagerel $LN9+61 
DD imagerel $unwind$main 
pdata ENDS 


pdata SEGMENT 
$pdata$main$filt$0 DD imagerel main$filt$0 


DD imagerel main$filt$0+32 
DD imagerel $unwind$main$filt$0 
pdata ENDS 


xdata SEGMENT 
$unwind$main DD 020609H 


DD 030023206H 
DD imagerel _ C specific handler 
DD 01H 
DD imagerel $LN9+8 
DD imagerel $LN9+40 
DD imagerel main$filt$0 
DD imagerel $LN9+40 
$unwind$main$filt$O DD 020601H 
DD 050023206H 
xdata ENDS 
TEXT | SEGMENT 
main PROC 
$LN9: 
push rbx 
sub rsp, 32 
xor ebx, ebx 
lea rcx, OFFSET FLAT:$SG86276 ; ‘hello #1!' 
call printf 
mov DWORD PTR [rbx], 13 
lea rcx, OFFSET FLAT:$SG86277 ; ‘hello #2!' 
call printf 
jmp SHORT $LN8@main 
$LN6@main: 
lea rcx, OFFSET FLAT:$SG86279 ; ‘access violation, can''t 
recover! 
call printf 
npad 1 ; align next label 
$LN8@main: 
xor eax, eax 
add rsp, 32 
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pop rbx 
ret 0 
main ENDP 
_ TEXT ENDS 


text$x SEGMENT 
main$filt$0 PROC 


push rbp 

sub rsp, 32 

mov rbp, rdx 
$LN5@main$filt$: 

mov rax, QWORD PTR [rcx] 

xor ecx, ecx 

cmp DWORD PTR [rax], -1073741819; c0000005H 

sete cl 

mov eax, ecx 
$LN7Gmain$filt$: 

add rsp, 32 

pop rbp 

ret 0 

int 3 


main$filt$0 ENDP 
text$x ENDS 


Listing 6.34: MSVC 2012 


$SG86277 DB ‘in filter. code=0x%08X', 0aH, 00H 

$5G86279 DB 'yes, that is our exception', OaH, OOH 
$5G86281 DB ‘not our exception', OaH, 00H 

$SG86288 DB 'hello!', OaH, 00H 

$5G86290 DB '0x112233 raised. now let''s crash', 0aH, 00H 
$5G86292 DB ‘access violation, can''t recover', 0aH, 00H 
$5G86294 DB ‘user exception caught', OaH, 00H 


pdata SEGMENT 
$pdata$filter user exceptions DD imagerel $LN6 


DD imagerel $LN6+73 

DD imagerel $unwind$filter user exceptions 
$pdata$main DD  imagerel $LN14 

DD imagerel $LN14+95 

DD imagerel $unwind$main 
pdata ENDS 


pdata SEGMENT 
$pdata$main$filt$0 DD imagerel main$filt$0 


DD imagerel main$filt$0+32 

DD imagerel $unwind$main$filt$0 
$pdata$main$filt$1 DD imagerel main$filt$1 

DD imagerel main$filt$1+30 

DD imagerel $unwind$main$filt$1 
pdata ENDS 


xdata SEGMENT 
$unwind$filter user exceptions DD 020601H 
DD 030023206H 
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$unwind$main DD 020609H 


DD 030023206H 
DD imagerel _ C specific handler 
DD 02H 
DD imagerel $LN14+8 
DD imagerel $LN14+59 
DD imagerel main$filt$0 
DD imagerel $LN14+59 
DD imagerel $LN14+8 
DD imagerel $LN14+74 
DD imagerel main$filt$1 
DD imagerel $LN14+74 
$unwind$main$filt$O DD 020601H 
DD 050023206H 
$unwind$main$filt$1 DD 020601H 
DD 050023206H 
xdata ENDS 
TEXT | SEGMENT 
main PROC 
$LN14: 
push rbx 
sub rsp, 32 
xor ebx, ebx 
lea rcx, OFFSET FLAT:$SG86288 ; 'hello!' 
call printf 
xor ród, r9d 
xor r8d, r8d 
xor edx, edx 
mov ecx, 1122867 ; 00112233H 
call QWORD PTR imp RaiseException 
lea rcx, OFFSET FLAT:$SG86290 ; '0x112233 raised. now let''s 
crash' 
call printf 
mov DWORD PTR [rbx], 13 
jmp SHORT $LN13@main 
$LN11@main: 
lea rcx, OFFSET FLAT:$SG86292 ; ‘access violation, can''t 
recover! 
call printf 
npad 1 ; align next label 
$LN13Gmain: 
jmp SHORT $LN9@main 
$LN7@main: 
lea rcx, OFFSET FLAT: $SG86294 ; ‘user exception caught ' 


call printf 
npad 1 ; align next label 


$LN9@main: 
xor eax, eax 
add rsp, 32 
pop rbx 
ret 0 

main ENDP 
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text$x SEGMENT 
main$filt$0 PROC 


push rbp 

sub rsp, 32 

mov rbp, rdx 
$LN10@main$filt$: 

mov rax, QWORD PTR [rcx] 

xor ecx, ecx 

cmp DWORD PTR [rax], -1073741819; c0000005H 

sete cl 

mov eax, ecx 
$LN12@main$filt$: 

add rsp, 32 

pop rbp 

ret 0 

int 3 


main$filt$0 ENDP 


main$filt$1 PROC 


push rbp 

sub rsp, 32 

mov rbp, rdx 
$LN6Gmain$filt$: 

mov rax, QWORD PTR [rcx] 

mov rdx, rcx 

mov ecx, DWORD PTR [rax] 

call filter user exceptions 

npad 1 ; align next label 
$LN8@main$filt$: 

add rsp, 32 

pop rbp 

ret 0 

int 3 


main$filt$1 ENDP 
text$x ENDS 


TEXT | SEGMENT 


code$ - 48 
ep$ - 56 
filter user exceptions PROC 
$LN6: 
push rbx 
sub rsp, 32 
mov ebx, ecx 
mov edx, ecx 
lea rcx, OFFSET FLAT:$SG86277 ; ‘in filter. code=0x%08X' 
call printf 
cmp ebx, 1122867; 00112233H 
jne SHORT $LN2@filter_ use 
lea rcx, OFFSET FLAT:$SG86279 ; 'yes, that is our exception' 
call printf 
mov eax, 1 
add rsp, 32 
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pop rbx 

ret 0 
$LN2Gfilter use: 

lea rcx, OFFSET FLAT:$SG86281 ; ‘not our exception' 

call printf 

xor eax, eax 

add rsp, 32 

pop rbx 

ret 0 
filter user exceptions ENDP 
TEXT ENDS 


Read [Igor Skochinsky, Compiler Internals: Exceptions and RTTI, (2012)] *’for more 
detailed information about this. 


Aside from exception information, .pdata is a section that contains the addresses 
of almost all function starts and ends, hence it may be useful for a tools targeted at 
automated analysis. 


Read more about SEH 


[Matt Pietrek, A Crash Course on the Depths of Win32™ Structured Exception Han- 
dling, (1997)]^?, [Igor Skochinsky, Compiler Internals: Exceptions and RTTI, (2012)] 
49 


6.5.4 Windows NT: Critical section 


Critical sections in any OS are very important in multithreaded environment, mostly 
for giving a guarantee that only one thread can access some data in a single moment 
of time, while blocking other threads and interrupts. 


That is how a CRITICAL SECTION structure is declared in Windows NT line OS: 
Listing 6.35: (Windows Research Kernel v1.2) public/sdk/inc/nturtl.h 


typedef struct RTL CRITICAL SECTION { 
PRTL CRITICAL SECTION DEBUG DebugInfo; 


// 
// The following three fields control entering and exiting the critical 


// section for the resource 
// 


LONG LockCount; 

LONG RecursionCount; 

HANDLE OwningThread; // from the thread's ClientId->UniqueThread 
HANDLE LockSemaphore; 


47 Also available as http: //yurichev.com/mirrors/RE/Recon-2012-Skochinsky-Compiler-Internals. 
pdf 

48 Also available as http: //www.microsoft.com/msj/0197/Exception/Exception.aspx 

^9AIso available as http: //yurichev.com/mirrors/RE/Recon- 2012-Skochinsky-Compiler-Internals. 
pdf 
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ULONG PTR SpinCount; // force size on 64-bit systems when packed 
) RTL CRITICAL SECTION, *PRTL CRITICAL SECTION; 


That's is how EnterCriticalSection() function works: 


Listing 6.36: Windows 2008/ntdll.dll/x86 (begin) 


_RtlEnterCriticalSection@4 


var_C = dword ptr -OCh 
var 8 - dword ptr -8 
var 4 - dword ptr -4 
arg 0 - dword ptr 8 
mov edi, edi 
push ebp 
mov ebp, esp 
sub esp, OCh 
push esi 
push edi 
mov edi, [ebp«arg 0] 
lea esi, [edi+4] ; LockCount 
mov eax, esi 
lock btr dword ptr [eax], 0 
jnb wait ; jump if CF=0 
loc 7DE922DD: 
mov eax, large fs:18h 
mov ecx, [eax+24h] 
mov [edi+0Ch], ecx 
mov dword ptr [edi+8], 1 
pop edi 
xor eax, eax 
pop esi 
mov esp, ebp 
pop ebp 
retn 4 


. skipped 


The most important instruction in this code fragment is BTR (prefixed with LOCK): 


the zeroth bit is stored in the CF flag and cleared in memory. This is an atomic 
operation, 


blocking all other CPUs' access to this piece of memory (see the LOCK prefix before 
the BTR instruction). If the bit at LockCount is 1, 


fine, reset it and return from the function: we are in a critical section. 
If not—the critical section is already occupied by other thread, so wait. 
The wait is performed there using WaitForSingleObject(). 


And here is how the LeaveCriticalSection() function works: 
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Listing 6.37: Windows 2008/ntdll.dll/x86 (begin) 


_RtlLeaveCriticalSection@4 proc near 


arg 0 


loc 7DE922B0: 


loc 7DE922B2: 


. Skipped 


- dword ptr 8 

mov edi, edi 

push ebp 

mov ebp, esp 

push esi 

mov esi, [ebp«arg 0] 

add dword ptr [esi+8], OFFFFFFFFh ; RecursionCount 
jnz short loc 7DE922B2 
push ebx 

push edi 

lea edi, [esi+4] ; LockCount 
mov dword ptr [esi+0Ch], 0 
mov ebx, 1 

mov eax, edi 

lock xadd [eax], ebx 

inc ebx 

cmp ebx, OFFFFFFFFh 

jnz loc 7DEA8EB7 

pop edi 

pop ebx 

xor eax, eax 

pop esi 

pop ebp 

retn 4 


XADD is "exchange and add". 


In this case, it adds 1 to LockCount, meanwhile saves initial value of LockCount in 
the EBX register. However, value in EBX is to incremented with a help of subsequent 
INC EBX, and it also will be equal to the updated value of LockCount. 


This operation is atomic since it is prefixed by LOCK as well, meaning that all other 


CPUs or CPU cores in system are blocked from accessing this point in memory. 


The LOCK prefix is very important: 


without it two threads, each of which works on separate CPU or CPU core can try 
to enter a critical section and to modify the value in memory, which will result in 
non-deterministic behavior. 
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Tools 


Now that Dennis Yurichev has made this book 
free (libre), it is a contribution to the world of 
free knowledge and free education. However, 
for our freedom's sake, we need free (libre) 
reverse engineering tools to replace the 
proprietary tools described in this book. 


Richard M. Stallman 


7.1 Binary analysis 


Tools you use when you don't run any process. 


(Free, open-source) enti: entropy analyzing tool. Read more about entropy: 9.2 
on page 1195. 


Hiew?: for small modifications of code in binary files. Has assembler/disassem- 
bler. 


(Free, open-source) GHex?: simple hexadecimal editor for Linux. 


(Free, open-source) xxd and od: standard UNIX utilities for dumping. 


(Free, open-source) strings: *NIX tool for searching for ASCII strings in binary 
files, including executable ones. Sysinternals has alternative^ supporting wide 
char strings (UTF-16, widely used in Windows). 


(Free, open-source) Binwalk?: analyzing firmware images. 


Thttp://ww. fourmilab.ch/random/ 

2hiew.ru 

3https://wiki.gnome.org/Apps/Ghex 
^nttps://technet.microsoft.com/en-us/sysinternals/strings 
5http://binwalk.org/ 
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* (Free, open-source) binary grep: a small utility for searching any byte sequence 

in a big pile of files, including non-executable ones: GitHub. There is also 
rafind2 in rada.re for the same purpose. 


7.1.1 Disassemblers 


IDA. An older freeware version is available for download ©. Hot-keys cheatsheet: 
.6.1 on page 1321 


Ghidra’ — free alternative to IDA from NSA?. 


Binary Ninja? 


(Free, open-source) zynamics BinNavi'? 


(Free, open-source) objdump: simple command-line utility for dumping and dis- 
assembling. 


(Free, open-source) readelf**: dump information about ELF file. 


7.1.2 Decompilers 


The best known is Hex-Rays: http://hex-rays.com/products/decompiler/. Read 
more about it: 11.9 on page 1267. 


There is also a free alternative from NSA: Ghidra??. 


7.1.3 Patch comparison/diffing 


You may want to use it when you compare original version of some executable and 
patched one, in order to find what has been patched and why. 


* (Free) zynamics BinDiff** 


* (Free, open-source) Diaphora** 


7.2 Live analysis 


Tools you use on a live system or during running of a process. 


Shex-rays.com/products/ida/support/download freeware.shtml 
7https://ghidra-sre.org/ 

8National Security Agency 

9http://binary.ninja/ 
IOhttps://www.zynamics.com/binnavi.html 
Hhttps://sourceware.org/binutils/docs/binutils/readelf.html 
12https://ghidra-sre.org/ 
I3https://www.zynamics.com/software.html 
Mhttps://github.com/joxeankoret/diaphora 
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7.2.1 Debuggers 


e (Free) OllyDbg. Very popular user-mode win32 debugger’?. Hot-keys cheat- 
sheet: .6.2 on page 1321 


(Free, open-source) GDB. Not quite popular debugger among reverse engineers, 
because it's intended mostly for programmers. Some commands: .6.5 on page 1322. 
There is a visual interface for GDB, “GDB dashboard”?*. 


(Free, open-source) LLDB?’. 


WinDbg??: kernel debugger for Windows. 


IDA has internal debugger. 


(Free, open-source) Radare AKA rada.re AKA r2??. A GUI also exists: ragui?°. 


(Free, open-source) tracer. The author often uses tracer ?! instead of a debug- 
ger. 


The author of these lines stopped using a debugger eventually, since all he 
needs from it is to spot function arguments while executing, or registers state 
at some point. Loading a debugger each time is too much, so a small utility 
called tracer was born. It works from command line, allows intercepting func- 
tion execution, setting breakpoints at arbitrary places, reading and changing 
registers state, etc. 


N.B.: the tracer isn't evolving, because it was developed as a demonstration 
tool for this book, not as everyday tool. 


7.2.2 Library calls tracing 


Itrace??. 


7.2.3 System calls tracing 
strace / dtruss 


It shows which system calls (syscalls(6.3 on page 950)) are called by a process right 
now. 


For example: 


# strace df -h 


I5ollydbg.de 

lóénttps://github.com/cyrus-and/gdb- dashboard 

Vhttp://lldb.llvm.org/ 
18https://developer.microsoft.com/en-us/windows/hardware/windows -driver-kit 
19http://rada.re/r/ 

20http://radare.org/ragui/ 

2lyurichev.com 

22 http: //www.ltrace.org/ 
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access("/etc/ld.so.nohwcap", F OK) = -1 ENOENT (No such file or 7 
y directory) 

open("/lib/i386-linux-gnu/libc.so.6", O RDONLY|O CLOEXEC) = 3 

read(3, "M177ELF2 


S N1IN1N1N000000N0N0N0N3N0N3N0N1N0N0N0N220N232N1N000440N0N0" ..., 2 
S 512) = 512 
fstat64(3, (st mode-S IFREG|0755, st size-1770984, ...}) = 0 


mmap2(NULL, 1780508, PROT READ|PROT EXEC, MAP PRIVATE|MAP DENYWRITE, 3, 0) 7 
& = 0xb75b3000 


Mac OS X has dtruss for doing the same. 


Cygwin also has strace, but as far as it’s known, it works only for .exe-files compiled 
for the cygwin environment itself. 


7.2.4 Network sniffing 


Sniffing is intercepting some information you may be interested in. 


(Free, open-source) Wireshark?? for network sniffing. It has also capability for USB 
sniffing?*. 


Wireshark has a younger (or older) brother tcpdump??, simpler command-line tool. 


7.2.5 Sysinternals 


(Free) Sysinternals (developed by Mark Russinovich) ?5. At least these tools are im- 
portant and worth studying: Process Explorer, Handle, VMMap, TCPView, Process 
Monitor. 


7.2.6 Valgrind 


(Free, open-source) a powerful tool for detecting memory leaks: http://valgrind. 
org/. Due to its powerful JIT mechanism, Valgrind is used as a framework for other 
tools. 


7.2.7 Emulators 


* (Free, open-source) QEMU?”: emulator for various CPUs and architectures. 
e (Free, open-source) DosBox??: MS-DOS emulator, mostly used for retrogaming. 


* (Free, open-source) SimH??: emulator of ancient computers, mainframes, etc. 


23https://www.wireshark.org/ 
24https://wiki.wireshark.org/CaptureSetup/USB 

?5http: //www.tcpdump.org/ 
26https://technet.microsoft.com/en-us/sysinternals/bb842062 
27http://qemu.org 

28https://www.dosbox.com/ 

?9http://simh.trailing-edge.com/ 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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7.3 Other tools 


Microsoft Visual Studio Express ??: Stripped-down free version of Visual Studio, con- 
venient for simple experiments. 


Some useful options: .6.3 on page 1322. 


There is a website named "Compiler Explorer", allowing to compile small code snip- 
pets and see output in various GCC versions and architectures (at least x86, ARM, 
MIPS): http://godbolt.org/—I would have used it myself for the book if | would 
know about it! 


7.3.1 SMT solvers 


From the reverse engineer's perspective, SMT solvers are used when dealing with 
amateur cryptography, symbolic/concolic execution, ROP chains generation. 


For more information, read: https://yurichev.com/writings/SAT SMT by example. 
pdf. 


7.3.2 Calculators 


Good calculator for reverse engineer's needs should support at least decimal, hex- 
adecimal and binary bases, as well as many important operations like XOR and shifts. 


* IDA has built-in calculator ("?"). 
* rada.re has rax2. 
* https://yurichev.com/progcalc/ 


* As a last resort, standard calculator in Windows has programmer's mode. 


7.4 Do You Think Something Is Missing Here? 


If you know a great tool not listed here, please drop a note: 
my emails. 


30visualstudio.com/en-US/products/visual-studio-express-vs 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Chapter 8 


Case studies 


Instead of epigraph: 


Peter Seibel: How do you tackle reading source code? Even read- 
ing something in a programming language you already know is a tricky 
problem. 

Donald Knuth: But it's really worth it for what it builds in your 
brain. So how do | do it? There was a machine called the Bunker Ramo 
300 and somebody told me that the Fortran compiler for this machine 
was really amazingly fast, but nobody had any idea why it worked. | 
got a copy of the source-code listing for it. | didn't have a manual for 
the machine, so | wasn't even sure what the machine language was. 

But | took it as an interesting challenge. | could figure out BEGIN 
and then | would start to decode. The operation codes had some two- 
letter mnemonics and so | could start to figure out "This probably was 
a load instruction, this probably was a branch." And | knew it was a 
Fortran compiler, so at some point it looked at column seven of a card, 
and that was where it would tell if it was a comment or not. 

After three hours | had figured out a little bit about the machine. 
Then | found these big, branching tables. So it was a puzzle and | kept 
just making little charts like l'm working at a security agency trying to 
decode a secret code. But | knew it worked and | knew it was a Fortran 
compiler—it wasn't encrypted in the sense that it was intentionally 
obscure; it was only in code because | hadn't gotten the manual for 
the machine. 

Eventually | was able to figure out why this compiler was so fast. 
Unfortunately it wasn't because the algorithms were brilliant; it was 
just because they had used unstructured programming and hand opti- 
mized the code to the hilt. 

It was just basically the way you solve some kind of an unknown 
puzzle— make tables and charts and get a little more information here 
and make a hypothesis. In general when I’m reading a technical paper, 
it’s the same challenge. I’m trying to get into the author's mind, trying 
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to figure out what the concept is. The more you learn to read other 
people's stuff, the more able you are to invent your own in the future, 
it seems to me. 


( Peter Seibel — Coders at Work: Reflections on the Craft of Programming ) 


8.1 Mahjong solitaire prank (Windows 7) 


Mahjong solitaire is a great game, but can we make it harder, by disabling the Hint 
menu item? 


In Windows 7, I can find Mahjong.dll and Mahjong.exe in: 

C: NWindowsNwinsxsN 

x86 microsoft-windows-s..inboxgames-shanghai 31bf3856ad364e35 6.1.7600.16385 none\ 
c07a51d9507d9398. 


Also, the Mahjong.exe.mui file in: 

C: NWindowsNwinsxsN 

x86 microsoft-windows-s..-shanghai.resources 31bf3856ad364e35 6.1.7600.16385 en-us 
. C430954533c66bf3 


and in 


C: NWindowsNwinsxsN 
x86 microsoft-windows-s..-shanghai.resources 31bf3856ad364e35 6.1.7600.16385 ru-ru 
. 0d51acf984cb679a. 


I’m using English Windows, but with Russian language support, so there are might be 
resource files for two languages. By opening Mahjong.exe.mui in Resource Hacker, 
there we can see a menu definition: 


Listing 8.1: Menu resources in Mahjong.exe.mui 


103 MENU 
LANGUAGE LANG ENGLISH, SUBLANG ENGLISH US 


POPUP "&Game" 

1 
MENUITEM "&New GameNtF2", 40000 
MENUITEM SEPARATOR 
MENUITEM "S&Undo\tCtrl+Z", 40001 
MENUITEM "S&Hint\tH", 40002 
MENUITEM SEPARATOR 
MENUITEM "&StatisticsNtF4", 40003 
MENUITEM "&OptionsNtF5", 40004 
MENUITEM "Change &AppearanceNtF7", 40005 
MENUITEM SEPARATOR 
MENUITEM "E&xit", 40006 


} 
POPUP "&Help" 


MENUITEM "&View HelpNtF1", 40015 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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MENUITEM "&About Mahjong Titans", 40016 
MENUITEM SEPARATOR 
MENUITEM "Get &More Games Online", 40020 
} 
} 


The Hint submenu has the 40002 code. Now I’m opening Mahjong.exe in IDA and 
find the 40002 value. 


(l'm writing this in November 2019. Somehow, IDA can't get PDBs from Microsoft 
servers. Maybe Windows 7 is unsupported anymore? Anyway, | can't get function 
names...) 


Listing 8.2: Mahjong.exe 


.text:010205C8 6A 03 push 3 
.text:010205CA 85 FF test edi, edi 
.text:010205CC 5B pop ebx 
.text:01020625 57 push edi ; uIDEnableItem 
.text:01020626 FF 35 C8 97 08 01 push hmenu ; hMenu 
.text:0102062C FF D6 call esi ; EnableMenuItem 
.text:0102062E 83 7D 08 01 cmp [ebp+arg 0], 1 
.text:01020632 BF 42 9C 00 00 mov edi, 40002 
.text:01020637 75 18 jnz short loc 1020651 ; must jump 
always 
.text:01020639 6A 00 push 0 ; uEnable 
.text:0102063B 57 push edi ; uIDEnableItem 
.text:0102063C FF 35 B4 8B 08 01 push hMenu ; hMenu 
.text:01020642 FF D6 call esi ; EnableMenuItem 
.text:01020644 6A 00 push 0 ; uEnable 
.text:01020646 57 push edi ; uIDEnableItem 
.text:01020647 FF 35 C8 97 08 01 push hmenu ; hMenu 
.text:0102064D FF D6 call esi ; EnableMenuItem 
.text:0102064F EB 1A jmp short loc 102066B 
.text:01020651 
.text:01020651 loc 1020651: ; CODE XREF: sub 1020581+B6 
.text:01020651 53 push ebx ; 3 
.text:01020652 57 push edi ; uIDEnableItem 
.text:01020653 FF 35 B4 8B 08 01 push hMenu ; hMenu 
.text:01020659 FF D6 call esi ; EnableMenuItem 
.text:0102065B 53 push ebx ES 
.text:0102065C 57 push edi ; ulIDEnableItem 
.text:0102065D FF 35 C8 97 08 01 push hmenu ; hMenu 
.text:01020663 FF D6 call esi ; EnableMenuItem 


This piece of code enables or disables the Hint menu item. 
And according to MSDN!: 
MF DISABLED | MF GRAYED = 3 and MF ENABLED = 0. 


lhttps://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-enablemenuitem 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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| think, this function enables or disables several menu items (Hint, Undo, etc), ac- 
cording to the value in arg 0. Because at start, when a user choose solitaire type, 
Hint and Undo items are disabled. They are enabled when the game has begun. 


So I’m patching the Mahjong.exe file at 0x01020637 by replacing 0x75 with OxEB 
byte, making this JNZ jump working always. Effectively, this will make calling EnableMenuItem(..., 
always. Now the Hint submenu is always disabled. 


Also, somehow, the EnableMenuItem() function called twice, for hMenu and for hmenu. 
Perhaps, the program has two menus, and maybe switching them? 


As a homework, try to disable Undo menu item, to make the game even harder. 


8.2 Task manager practical joke (Windows Vista) 
Let's see if it's possible to hack Task Manager slightly so it would detect more CPU 
cores. 

Let us first think, how does the Task Manager know the number of cores? 


There is the GetSystemInfo() win32 function present in win32 userspace which can 
tell us this. But it’s not imported in taskmgr.exe. 


There is, however, another one in NTAPI, NtQuerySystemInformation(), which is 
used in taskmgr.exe in several places. 


To get the number of cores, one has to call this function with the SystemBasicInformation 
constant as a first argument (which is zero ?). 


The second argument has to point to the buffer which is getting all the information. 


So we have to find all calls to the 
NtQuerySystemInformation(0, ?, ?, ?) function. Let's open taskmgr.exe in 
IDA. 


What is always good about Microsoft executables is that IDA can download the cor- 
responding PDB file for this executable and show all function names. 


It is visible that Task Manager is written in C++ and some of the function names and 
classes are really speaking for themselves. There are classes CAdapter, CNetPage, 
CPerfPage, CProcinfo, CProcPage, CSvcPage, CTaskPage, CUserPage. 


Apparently, each class corresponds to each tab in Task Manager. 


Let's visit each call and add comment with the value which is passed as the first 
function argument. We will write "not zero" at some places, because the value there 
was clearly not zero, but something really different (more about this in the second 
part of this chapter). 


And we are looking for zero passed as argument, after all. 


2MSDN 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1014 


xrefsto — imp NtQuerySystemInformation 


Die. [T.[Adkes — — — — Tet — 0 0 0 000000 8 | 


ld Up p  wWwinMain«5DE cal cs; imp NtQuerySystemlnformation; O 
win ain+542 cal cs; imp NtQuerySystemlnformation; 2 


CPerfPage::TimerE vent[void]- 200 cal «cs; imp_NtQuerySysteminformation; not zero 
p InitPerflnfo[void}+2C cal cs; imp NtQuerySystemlnformation; O 
p  InitPerflnfof[void)+F0 cal cs; imp NtuerySystemlnformation; 8 
p CalcCpuTime[int]-5F cal cs; imp NtQuerySystemlnformation; 8 
p CalcCpuTime(int]-248 cal cs; imp NtQuerySystemlnformation; 2 
p  CPerfPage::CalcPhysicaldem(unsigned ... call cs; imp NtQuerySystemlnformation; not zero 
p  CPerfPage::CalcPhysicaldem(unsigned ... call cs; imp NtQuerySystemlnformation; not zero 
p  CProcPage::GetProcess|nfo[void)+2B cal cs; imp_NtQuerySysteminformation; 5 
p CProcPage::UpdateProclnfa&rray[void]*... call cs; imp NtQuerySystemlnformation; O 
p CProcPage:lpdateProclnfo&rray[void]e... cal cs:__imp_NtQuerySystemlnformation; 2 
p CProcPage:lnitialize(Hw/ND — *}+201 cal cs; imp NtQuerySystemlnformation; O 
p CProcPage::GetT askListE x[void]+3C cal cs; imp NtQuerySystemlnformation; 5 


Figure 8.1: IDA: cross references to NtQuerySystemlnformation() 


Yes, the names are really speaking for themselves. 


When we closely investigate each place where 
NtQuerySystemInformation(0, ?, ?, ?) is called, we quickly find what we need 
in the InitPerfInfo() function: 


Listing 8.3: taskmgr.exe (Windows Vista) 


. text: 10000B4B3 xor r9d, r9d 

. text: 10000B4B6 lea rdx, [rsp+0C78h+var_C58] ; buffer 

. text: 10000B4BB xor ecx, ecx 

. text: 10000B4BD lea ebp, [r9+40h] 

. text: 10000B4C1 mov r8d, ebp 

. text: 10000B4C4 call cs: imp NtQuerySystemInformation ; 0 
.text:10000BACA xor ebx, ebx 

.text:10000BACC cmp eax, ebx 

.text:10000BACE jge short loc 10000B4D7 

.text:10000B4DO 

.text:10000BA4DO loc 10000B4D0: ; CODE XREF: 


InitPerfinfo(void)+97 
. text: 10000B4D0 ; 
InitPerfInfo(void)+AF 
. text: 10000B4D0 xor al, al 
. text: 10000B4D2 jmp loc 10000B5EA 
.text:10000B4D7 ; 


.text:10000B4D7 


.text:10000B4D7 loc 10000BA4D7: ; CODE XREF: 
InitPerfinfo(void)+36 

. text: 10000B4D7 mov eax, [rsp+0C78h+var_C50] 

. text: 10000B4DB mov esi, ebx 

. text: 10000B4DD mov rl2d, 3E80h 

. text: 10000B4E3 mov cs:?g PageSize@@3KA, eax ; ulong g PageSize 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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. text: 10000B4E9 shr eax, OAh 

. text: 10000B4EC lea r13,  ImageBase 

. text: 10000B4F3 imul eax, [rsp+0C78h+var_C4C] 

. text: 10000B4F8 cmp [rsp+0C78h+var_C20], bpl 

. text: 10000B4FD mov cs:?g MEMMax@@3_ JA, rax ; | int64 g MEMMax 
.text:10000B504 movzx eax, [rsp+0C78h+var_C20] ; number of CPUs 
.text:10000B509 cmova eax, ebp 

. text: 10000B50C cmp al, bl 

. text: 10000B50E mov Cs:?g cProcessors@@3EA, al ; 


uchar g cProcessors 


g cProcessors is a global variable, and this name has been assigned by IDA accord- 
ing to the PDB loaded from Microsoft's symbol server. 


The byte is taken from var C20. And var C58 is passed to 
NtQuerySystemInformation() as a pointer to the receiving buffer. The difference 
between 0xC20 and 0xC58 is 0x38 (56). 


Let's take a look at format of the return structure, which we can find in MSDN: 


typedef struct SYSTEM BASIC INFORMATION { 
BYTE Reserved1[24]; 
PVOID Reserved2[4]; 
CCHAR NumberOfProcessors; 

) SYSTEM BASIC INFORMATION; 


This is a x64 system, so each PVOID takes 8 bytes. 
All reserved fields in the structure take 24 + 4 + 8 = 56 bytes. 


Oh yes, this implies that var C20 is the local stack is exactly the NumberOfProcessors 
field of the SYSTEM BASIC INFORMATION structure. 


Let's check our guess. Copy taskmgr.exe from C:\Windows\System32 to some 
other folder (so the Windows Resource Protection will not try to restore the patched 
taskmgr.exe). 


Let's open it in Hiew and find the place: 


Figure 8.2: Hiew: find the place to be patched 


Let's replace the MOVZX instruction with ours. Let's pretend we've got 64 CPU cores. 


Add one additional NOP (because our instruction is shorter than the original one): 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


Figure 8.3: Hiew: patch it 


And it works! Of course, the data in the graphs is not correct. 
At times, Task Manager even shows an overall CPU load of more than 10096. 
LJ Windows Task Manager 


File Options View Help 
| Applications | Processes | Services | Performance | Networking | Users | 


Memory Physical Memory Usage History 


Figure 8.4: Fooled Windows Task Manager 


The biggest number Task Manager does not crash with is 64. 


Apparently, Task Manager in Windows Vista was not tested on computers with a large 
number of cores. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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So there are probably some static data structure(s) inside it limited to 64 cores. 


8.2.1 Using LEA to load values 


Sometimes, LEA is used in taskmgr.exe instead of MOV to set the first argument of 
NtQuerySystemInformation(): 


Listing 8.4: taskmgr.exe (Windows Vista) 


xor r9d, r9d 
div dword ptr [rsp+4C8h+WndClass.lpfnwWndProc] 
lea rdx, [rsp+4C8h+VersionInformation] 
lea ecx, [r9+2] ; put 2 to ECX 
mov r8d, 138h 
mov ebx, eax 
; ECX=SystemPerformanceInformation 
call cs: imp NtQuerySystemInformation ; 2 
mov r8d, 30h 
lea r9, [rsp+298h+var_268] 
lea rdx, [rsp+298h+var_258] 
lea ecx, [r8-2Dh] ; put 3 to ECX 
; ECXsSystemTimeOfDayInformation 
call cs: imp NtQuerySystemInformation ; not zero 
mov rbp, [rsi+8] 
mov r8d, 20h 
lea r9, [rsp+98h+arg 0] 
lea rdx, [rsp+98h+var_78] 
lea ecx, [r8+2Fh] ; put Ox4F to ECX 
mov [rsp-98h-var 60], ebx 
mov [rsp+98h+var_68], rbp 
; ECX=SystemSuperfetchInformation 
call cs: imp NtQuerySystemInformation ; not zero 


Perhaps MSVC did so because machine code of LEA is shorter than MOV REG, 5 
(would be 5 instead of 4). 


LEA with offset in -128..127 range (offset will occupy 1 byte in opcode) with 32-bit 
registers is even shorter (for lack of REX prefix)—3 bytes. 


Another example of such thing is: 6.1.5 on page 938. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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8.3 Color Lines game practical joke 


This is a very popular game with several implementations in existence. We can take 


one of them, called BallTriX, from 1997, available freely at https://archive.org/ 
details/BallTriX 1020 3. Here is how it looks: 


5 Balltrix 


Lol xl 
File Help 


Total cells: 
Cells left: 


Row: 


Figure 8.5: This is how the game is usually looks like 


30r at  https://web.archive.org/web/20141110053442/http: //www.download- central.ws/ 
Win32/Games/B/BallTriX/ or http://www. benya.com/balltrix/. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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So let's see, is it be possible to find the random generator and do some trick with it. 
IDA quickly recognize the standard rand function in balltrix.exe at 0x00403DA0. 
IDA also shows that it is called only from one place: 


.text:00402C9C sub 402C9C proc near ; 
CODE XREF: sub 402ACA+52 

.text:00402C9C ; sub 402ACA+64 ... 

.text:00402C9C 

.text:00402C9C arg 0 = dword ptr 8 

.text:00402C9C 

.text:00402C9C push ebp 

.text:00402C9D mov ebp, esp 

.text:00402C9F push ebx 

. text: 00402CA0 push esi 

. text: 00402CA1 push edi 

. text: 00402CA2 mov eax, dword 40D430 

. text: 00402CA7 imul eax, dword 40D440 

. text: 00402CAE add eax, dword 40D5C8 

. text: 00402CB4 mov ecx, 32000 

. text: 00402CB9 cdq 

. text: 00402CBA idiv ecx 

.text:00402CBC mov dword 40D440, edx 

.text:00402CC2 call rand 

.text:00402CC7 cdq 

.text:00402CC8 idiv [ebp+arg_ 0] 

.text:00402CCB mov dword 40D430, edx 

.text:00402CD1 mov eax, dword 40D430 

.text:00402CD6 jmp $45 

.text:00402CDB pop edi 

.text:00402CDC pop esi 

.text:00402CDD pop ebx 

.text:00402CDE leave 

.text:00402CDF retn 

.text:00402CDF sub 402C9C endp 


We'll call it “random”. Let's not to dive into this function's code yet. 
This function is referred from 3 places. 


Here are the first two: 


.text:00402B16 mov eax, dword 40C03C ; 10 here 
.text:00402B1B push eax 

.text:00402B1C call random 

.text:00402B21 add esp, 4 

.text:00402B24 inc eax 

.text:00402B25 mov [ebp-var C], eax 
.text:00402B28 mov eax, dword 40C040 ; 10 here 
.text:00402B2D push eax 

.text:00402B2bE call random 

.text:00402B33 add esp, 4 


Here is the third one: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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. text: 00402BBB 
. text: 00402BC0 
. text: 00402BC1 
. text: 00402BC6 
. text: 00402BC9 


mov 
push 
call 
add 
inc 


eax, dword 40C058 ; 5 here 
eax 

random 

esp, 4 

eax 


So the function has only one argument. 


10 is passed in first two cases and 5 in third. We can also notice that the board 
has a size of 10*10 and there are 5 possible colors. This is it! The standard rand() 
function returns a number in the 0. .0x7FFF range and this is often inconvenient, so 
many programmers implement their own random functions which returns a random 
number in a specified range. In our case, the range is 0..n- 1 and n is passed as the 


sole argument of the function. We can quickly check this in any debugger. 


So let's fix the third function call to always return zero. First, we will replace three 
instructions (PUSH/CALL/ADD) by NOPs. Then we'll add XOR EAX, EAX instruction, to 


clear the EAX register. 


.00402BB8: 83C410 
.00402BBB: A158C04000 
.00402BC0: 31C0 
.00402BC2: 90 
.00402BC3: 90 
.00402BC4: 90 
.00402BC5: 90 
.00402BC6: 90 
.00402BC7: 90 
.00402BC8: 90 
.00402BC9: 40 
.00402BCA: 8B4DF8 
.00402BCD: 8D0C49 
.00402BD0: 8B15F4D54000 


add 
mov 
xor 
nop 
nop 
nop 
nop 
nop 
nop 
nop 
inc 
mov 
lea 
mov 


esp,010 
eax, [00040C058] 
eax,eax 


eax 
ecx, [ebp] [-8] 
ecx, [ecx] [ecx]*2 
edx, [00040D5F4] 


So what we did is we replaced a call to the random() function by a code which always 


returns zero. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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Let's run it now: 


X ]BaliTrix loj xl 
Ele Help 


Score: 


7 o 
EE ERE LER DRE ERES RR 
a ee 
Cells left: 83 
vm F—| @ | @ | /| || 


Figure 8.6: Practical joke works 


Oh yes, it works^. 


But why are the arguments to the random() functions global variables? That’s just 
because it's possible to change the board size in the game's settings, so these values 
are not hardcoded. The 10 and 5 values are just defaults. 


8.4 Minesweeper (Windows XP) 
For those who are not very good at playing Minesweeper, we could try to reveal the 
hidden mines in the debugger. 


As we know, Minesweeper places mines randomly, so there has to be some kind of 
random number generator or a call to the standard rand() C-function. 


What is really cool about reversing Microsoft products is that there are PDB file with 
symbols (function names, etc). When we load winmine. exe into IDA, it downloads 
the PDB file exactly for this executable and shows all names. 


So here it is, the only call to rand() is this function: 


.text:01003940 ; — stdcall Rnd(x) 

.text:01003940 Rnd@4 proc near ; CODE XREF: 
StartGame()+53 

.text:01003940 ; StartGame()+61 

.text:01003940 

.text:01003940 arg 0 - dword ptr 4 


^Author of this book once did this as a joke for his coworkers with the hope that they would stop playing. 
They didn't. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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.text:01003940 


.text:01003940 call ds: imp rand 
.text:01003946 cdq 

.text:01003947 idiv [esp+arg 0] 
.text:0100394B mov eax, edx 
.text:0100394D retn 4 
.text:0100394D Rnd@4 endp 


IDA named it so, and it was the name given to it by Minesweeper's developers. 


The function is very simple: 


int Rnd(int limit) 
1 


F 


return rand() % limit; 


(There is no “limit” name in the PDB file; we manually named this argument like 
this.) 


So it returns a random value from 0 to a specified limit. 


Rnd() is called only from one place, a function called StartGame(), and as it seems, 
this is exactly the code which place the mines: 


.text:010036C7 push _xBoxMac 

.text:010036CD call _Rnd@4 ; Rnd(x) 

. text: 010036D2 push _yBoxMac 

.text:010036D8 mov esi, eax 

.text:010036DA inc esi 

.text:010036DB call _Rnd@4 ; Rnd(x) 

. text: 010036E0 inc eax 

.text:010036E1 mov ecx, eax 

.text:010036E3 shl ecx, 5 ; ECX=ECX*32 
. text: 010036E6 test _rgBlk[ecx+esil, 80h 

. text: 010036EE jnz short loc 10036C7 
.text:010036F0 shl eax, 5 ; EAX=EAX*32 
. text: 010036F3 lea eax, _rgBlk[eax+esi] 

. text: 010036FA or byte ptr [eax], 80h 

. text: 010036FD dec _cBombStart 

. text: 01003703 jnz short loc 10036C7 


Minesweeper allows you to set the board size, so the X (xBoxMac) and Y (yBoxMac) 
of the board are global variables. They are passed to Rnd() and random coordinates 
are generated. A mine is placed by the OR instruction at 0x010036FA. And if it has 
been placed before (it's possible if the pair of Rnd() generates a coordinates pair 
which has been already generated), then TEST and JNZ at 0x010036E6 jumps to the 
generation routine again. 


cBombStart is the global variable containing total number of mines. So this is loop. 


The width of the array is 32 (we can conclude this by looking at the SHL instruction, 
which multiplies one of the coordinates by 32). 
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The size of the rgBlk global array can be easily determined by the difference be- 


tween the rgBlk label in the data segment and the next known one. It is 0x360 
(864): 


.data:01005340 _rgBlk db 360h dup(?) ; DATA XREF: 
MainWwndProc(x,x,x,x)-4574 

.data:01005340 ; DisplayBlk(x,x)+23 

.data:010056A0 Preferences dd ? ; DATA XREF: 


FixMenus ()+2 


864/32 = 27. 


So the array size is 27+ 32? It is close to what we know: when we try to set board size 
to 100 + 100 in Minesweeper settings, it fallbacks to a board of size 24 + 30. So this is 
the maximal board size here. And the array has a fixed size for any board size. 


So let's see all this in OllyDbg. We will ran Minesweeper, attaching OllyDbg to it and 
now we can see the memory dump at the address of the rgBlk array (0x01005340) 
5 


So we got this memory dump of the array: 


Address Hex dump 

01005340 10 10 10 10|10 10 10 10|10 10 10 OF|OF OF OF OF| 
01005350 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005360 10 OF OF OF|OF OF OF OF|OF OF 10 OF|OF OF OF OF| 
01005370 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005380 10 OF OF OF|OF OF OF OF|OF OF 10 OF|OF OF OF OF| 
01005390 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
010053A0 10 OF OF OF|OF OF OF OF|8F OF 10 OF|OF OF OF OF] 
010053B0 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
010053C0 10 OF OF OF|OF OF OF OF|OF OF 10 OF|OF OF OF OF| 
010053D0 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
010053bE0 10 OF OF OF|OF OF OF OF|OF OF 10 OF|OF OF OF OF| 
010053F0 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005400 10 OF OF 8F|OF OF 8F OF|OF OF 10 OF|OF OF OF OF] 
01005410 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005420 10 8F OF OF|8F OF OF OF|OF OF 10 OF|OF OF OF OF| 
01005430 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005440 10 8F OF OF|OF OF 8F OF|OF 8F 10 OF|OF OF OF OF| 
01005450 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005460 10 OF OF OF|OF 8F OF OF|OF 8F 10 OF|OF OF OF OF] 
01005470 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
01005480 10 10 10 10/10 10 10 10|10 10 10 OF|OF OF OF OF| 
01005490 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
010054A0 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
010054B0 OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 
010054CO OF OF OF OF|OF OF OF OF|OF OF OF OF|OF OF OF OF| 


OllyDbg, like any other hexadecimal editor, shows 16 bytes per line. So each 32-byte 
array row occupies exactly 2 lines here. 


5All addresses here are for Minesweeper for Windows XP SP3 English. They may differ for other service 
packs. 
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This is beginner level (9*9 board). 
There is some square structure can be seen visually (0x10 bytes). 


We will click "Run" in OllyDbg to unfreeze the Minesweeper process, then we'll clicked 
randomly at the Minesweeper window and trapped into mine, but now all mines are 
visible: 


+ minesweeper MEE 


Game Help 


Figure 8.7: Mines 


By comparing the mine places and the dump, we can conclude that 0x10 stands for 
border, OxOF—empty block, Ox8F—mine. Perhaps, 0x10 is just a sentinel value. 


Now we'll add comments and also enclose all Ox8F bytes into square brackets: 


border: 
01005340 10 10 10 10 10 10 10 10 10 10 10 OF OF OF OF OF 
01005350 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #1: 
01005360 10 OF OF OF OF OF OF OF OF OF 10 OF OF OF OF OF 
01005370 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #2: 
01005380 10 OF OF OF OF OF OF OF OF OF 10 OF OF OF OF OF 
01005390 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #3: 
010053A0 10 OF OF OF OF OF OF OF[8F]OF 10 OF OF OF OF OF 
010053B0 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #4: 
010053CO 10 OF OF OF OF OF OF OF OF OF 10 OF OF OF OF OF 
010053D0 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #5: 
010053E0 10 OF OF OF OF OF OF OF OF OF 10 OF OF OF OF OF 
010053FO OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #6: 
01005400 10 OF OF[8F]OF OF[8F]OF OF OF 10 OF OF OF OF OF 
01005410 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
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line #7: 
01005420 10[8F]OF OF[8F]OF OF OF OF OF 10 OF OF OF OF OF 
01005430 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #8: 
01005440 10[8F]OF OF OF OF[8F]OF OF[8F]10 OF OF OF OF OF 
01005450 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
line #9: 
01005460 10 OF OF OF OF[8F]OF OF OF[8F]10 OF OF OF OF OF 
01005470 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 
border: 
01005480 10 10 10 10 10 10 10 10 10 10 10 OF OF OF OF OF 
01005490 OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF OF 


Now we'll remove all border bytes (0x10) and what's beyond those: 


OF OF OF OF OF OF OF OF OF 
OF OF OF OF OF OF OF OF OF 
OF OF OF OF OF OF OF[8F]OF 
OF OF OF OF OF OF OF OF OF 
OF OF OF OF OF OF OF OF OF 
OF OF[8F]OF OF[8F]OF OF OF 
[8F]OF OF[8F]OF OF OF OF OF 
[8F]OF OF OF OF[8F]OF OF[8F] 
OF OF OF OF[8F]OF OF OF[8F] 


Yes, these are mines, now it can be clearly seen and compared with the screenshot. 
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What is interesting is that we can modify the array right in OllyDbg. We can re- 
move all mines by changing all Ox8F bytes by OxOF, and here is what we'll get in 
Minesweeper: 


Game Help 


Figure 8.8: All mines are removed in debugger 


We can also move all of them to the first line: 


* Minesweeper Fla x| 


Game Help 


Figure 8.9: Mines set in debugger 


Well, the debugger is not very convenient for eavesdropping (which is our goal any- 
way), so we'll write a small utility to dump the contents of the board: 


// Windows XP MineSweeper cheater 
// written by dennis(a)yurichev.com for http://beginners.re/ book 
#include «windows.h» 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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#include <assert.h> 
#include <stdio.h> 


int main (int argc, char * argv[]) 
{ 
int i, j; 
HANDLE h; 
DWORD PID, address, rd; 
BYTE board[27] [32]; 


if (argc!=3) 

{ 
printf ("Usage: %s <PID> <address>\n", argv[0]); 
return 0; 


un 


assert (argv[1]!zNULL) ; 
assert (argv[2] !zNULL) ; 


assert (sscanf (argv[1], "*d", &PID)==1); 
assert (sscanf (argv[2], "%x", &address)--1); 


h=OpenProcess (PROCESS VM OPERATION | PROCESS VM READ | 7 
Y PROCESS VM WRITE, FALSE, PID); 


if (h==NULL) 
{ 


DWORD e=GetLastError(); 
printf ("OpenProcess error: %08X\n", e); 
return 0; 


u 


if (ReadProcessMemory (h, (LPVOID)address, board, sizeof(board), &/ 


S rd) !=TRUE) 
{ 
printf ("ReadProcessMemory() failed\n") ; 
return 0; 


un 


for (i=1; i<26; i++) 
{ 
if (board[i][0]220x10 && board[i] [1]==0x10) 
break; // end of board 
for (j=1; j<31; j++) 


{ 
if (board[i][j]==0x10) 
break; // board border 
if (board[i] [j]==0x8F) 
printf ("*"); 
else 
printf (" "); 
}; 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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printf ("Xn"); 
}; 


CloseHandle (h); 
ur 


Just set the PIDÓ 7 and the address of the array (0x01005340 for Windows XP SP3 
English) and it will dump it 9. 


It attaches itself to a win32 process by PID and just reads process memory at the 
address. 


8.4.1 Finding grid automatically 


This is kind of nuisance to set address each time when we run our utility. Also, various 
Minesweeper versions may have the array on different address. Knowing the fact 
that there is always a border (0x10 bytes), we can just find it in memory: 


// find frame to determine the address 
process mem-(BYTE*)malloc(process mem size); 
assert (process mem!-NULL); 


if (ReadProcessMemory (h, (LPVOID)start addr, process mem, 7 
S process mem size, &rd)!=TRUE) 
1 
printf ("ReadProcessMemory() failed\n"); 
return 0; 


}; 


// for 9*9 grid. 
// FIXME: slow! 
for (i=0; i<process mem size; i++) 
{ 
if (memcmp(process_mem+i, "\x10\x10\x10\x10\x10\x10\x10\x107 
S \x10\x10\x10\xOF\ xXOF\xXOF\XOF\XOF\XOF\XOF\xXOF\XOF\XOF\XOF\XOF\XOF\XOF\ 2 
V XOF\XOF\XOF\XOF\XOF\XOF\XOF\x10", 32)==0) 


{ 
// found 
address=start_addr+i; 
break; 
}; 
}; 
if (address==0) 
{ 
printf ("Can't determine address of frame (and grid)\n"); 
return 0; 
} 
else 
{ 


SProgram/process ID 


7PID it can be seen in Task Manager (enable it in “View > Select Columns”) 
9The compiled executable is here: beginners.re 
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printf ("Found frame and grid at Ox*xMn", address); 


}; 


Full source code: https://beginners.re/paywall/REAB- source/current-tree/ 
/examples/minesweeper/minesweeper cheater2.c. 


8.4.2 Exercises 


* Why do the border bytes (or sentinel values) (0x10) exist in the array? 


What they are for if they are not visible in Minesweeper's interface? How could 
it work without them? 


* As it turns out, there are more values possible (for open blocks, for flagged by 
user, etc). Try to find the meaning of each one. 


* Modify my utility so it can remove all mines or set them in a fixed pattern that 
you want in the Minesweeper process currently running. 


8.5 Hacking Windows clock 


Sometimes | do some kind of first April prank for my coworkers. 


Let's find, if we could do something with Windows clock? Can we force to go clock 
hands backwards? 


First of all, when you click on date/time in status bar, 
a C:\WINDOWS\SYSTEM32\TIMEDATE.CPL module gets executed, which is usual ex- 
ecutable PE-file. 


Let's see, how it draw hands? When | open the file (from Windows 7) in Resource 
Hacker, there are clock faces, but with no hands: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1030 


Resource Hacker - timedate.cpl - [nj x} 


Dommas,.» 


J) MUI 

wy 1: 1033 

jj PNGFILE 
w 
vy 5001: 1033 
uy 5002: 1033 
vy 5003: 1033 
vy 5004: 1033 
vy 5005: 1033 
uy 5006 : 1033 
vy 5007 : 1033 
vy 5008 : 1033 
wy 5009: 1033 
vy 5010: 1033 
wy 5011: 1033 


E O uru e 


24,847 | | | 130x 130 PNG Z 


Figure 8.10: Resource Hacker 


OK, what we know? How to draw a clock hand? All they are started at the middle 
of circle, ending with its border. Hence, we must calculate coordinates of a point 
on circle's border. From school-level mathematics we may recall that we have to 
use sine/cosine functions to draw circle, or at least square root. There are no such 
things in TIMEDATE.CPL, at least at first glance. But, thanks to Microsoft debug- 
ging PDB files, | can find a function named CAnalogClock::DrawHand(), which calls 
Gdiplus::Graphics::DrawLine() at least twice. 


Here is its code: 


.text:6EB9DBC7 ; private: enum Gdiplus: :Status  thiscall 
CAnalogClock:: DrawHand(class Gdiplus::Graphics *, int, struct ClockHand 
const &, class Gdiplus::Pen * 
.text:6EB9DBC7 ? DrawHand@CAnalogClock@@AAE? ^ 
y AW4Status@GdiplLus@@PAVGraphics@3@HABUC LockHand@@PAVPen@3@@Z proc near 
. text: 6EB9DBC7 ; CODE XREF: CAnalogClock:: ClockPaint(HDC__ *)+163 
. text: 6EB9DBC7 ; CAnalogClock:: ClockPaint(HDC__ *)+18B 
. text: 6EB9DBC7 
.text:6EB9DBC7 var 10 
.text:6EB9DBC7 var C 


dword ptr -10h 
dword ptr -0Ch 


.text:6EB9DBC7 var 8 dword ptr -8 
.text:6EBO9DBC7 var 4 dword ptr -4 
. text: 6EB9DBC7 arg 0 dword ptr 8 
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.text:6EB9DBC7 arg 4 
.text:6EB9DBC7 arg 8 
.text:6EB9DBC7 arg C 
. text: 6EB9DBC7 
. text: 6EB9DBC7 
. text: 6EB9DBC9 
. text: 6EB9DBCA 
. text : 6EB9DBCC 
. text: 6EB9DBCF 
. text: 6EB9DBD2 
. text: 6EB9DBD3 
. text: 6EB9DBD4 
. text: 6EB9DBD5 
. text: 6EB9DBD6 
. text: 6EB9DBD8 
. text: 6EB9DBDA 
. text: 6EB9DBDB 
. text: 6EB9DBDD 
.text:6EB9DBDF 
. text: 6EB9DBE6 
. text: 6EB9DBE9 
. text: 6EB9DBEA 
. text: 6EB9DBEC 
.text:6EB9DBEF 
. text: 6EB9DBF2 
. text: 6EB9DBF9 
. text: 6EB9DBFC 


mov 
push 
mov 
sub 
mov 
push 
push 
push 
cdq 
push 
mov 
pop 
idiv 
push 
lea 
lea 
cdq 
idiv 
mov 
mov 
lea 
mov 
call 


dword ptr OCh 
dword ptr 10h 
dword ptr 14h 


edi, edi 

ebp 

ebp, esp 

esp, 10h 

eax, [ebptarg 4] 
ebx 

esi 

edi 


3Ch 

esi, ecx 

ecx 

ecx 

2 

ebx, table[edx*8] 
eax, [edx+1Eh] 


ecx 
ecx, [ebptarg 0] 

[ebp+var_4], ebx 

eax, table[edx*8] 
[ebp+arg 4], eax 

22 


S SetInterpolationMode@Graphics@Gdip Lus@@QAE? 7 
V AW4Status@2@W4InterpolationMode@2@@Z ; 
Gdiplus::Graphics::SetInterpolationMode (Gdiplus::InterpolationMode) 


.text:6EB9DCO1 
.text:6EB9DC04 
. text: 6EB9DCO7 
.text:6EB9DCOA 
. text: 6EB9DCOD 
.text:6EB9DC10 
. text: 6EB9DC12 
.text:6EB9DC15 
. text: 6EB9DC1A 
. text: 6EB9DC1B 
. text: 6EB9DC1E 
MulDiv (x,x,x) 
.text:6EB9DC24 
. text: 6EB9DC26 
. text: 6EB9DC29 
.text:6EB9DC2E 
.text:6EB9DC31 
. text: 6EB9DC33 
. text: 6EB9DC36 
.text:6EB9DC37 
. text: 6EB9DC3A 
. text: 6EB9DC3C 
.text:6EB9DC3E 
.text:6EB9DCA1 


mov 
mov 
mov 
mov 
mov 
mov 
sub 
push 
push 
push 
mov 


call 
add 
push 
mov 
mov 
sub 
push 
mov 
push 
call 
add 
mov 


eax, [esi+70h] 
edi, [ebptarg 8] 
[ebp+var_10], eax 
eax, [esi+74h] 
[ebp+var_C], eax 


eax, [edi] 

eax, [edi+8] 

8000 ; nDenominator 
eax ; nNumerator 


dword ptr [ebx+4] ; nNumber 
ebx, ds: imp MulDivQ12 ; 


ebx ; MulDiv(x,x,x) ; MulDiv(x,x,x) 
eax, [esi+74h] 

8000 ; nDenominator 
[ebp+arg 8], eax 

eax, [edi] 

eax, [edi+8] 

eax ; nNumerator 

eax, [ebptvar_ 4] 

dword ptr [eax] ; nNumber 

ebx ; MulDiv(x,x,x) ; MulDiv(x,x,x) 
eax, [esi+70h] 

ecx, [ebp«arg 0] 
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. text : 6EB9DC44 mov [ebp+var_8], eax 

. text: 6EB9DC47 mov eax, [ebp+arg 8] 

. text: 6EB9DC4A mov [ebp+var_4], eax 

. text: 6EB9DC4D lea eax, [ebp+var 8] 

. text: 6EB9DC50 push eax 

. text: 6EB9DC51 lea eax, [ebp«var 10] 

. text: 6EB9DC54 push eax 

. text: 6EB9DC55 push [ebp+arg_ C] 

. text: 6EB9DC58 call ?DrawLine@Graphics@Gdiplus@@QAE? 7 


4 AW4Status@2@PBVPen@2@ABVPoint@2@1@Z ; 
Gdiplus::Graphics::DrawLine(Gdiplus::Pen const *,Gdiplus::Point const 
&,Gdiplus::Point const &) 


. text: 6EB9DC5D mov ecx, [edi+8] 

. text: 6EB9DC60 test ecx, ecx 

. text: 6EB9DC62 jbe short loc _6EB9DCAA 

. text: 6EB9DC64 test eax, eax 

. text: 6EB9DC66 jnz short loc_6EB9DCAA 

. text: 6EB9DC68 mov eax, [ebptarg 4] 

. text: 6EB9DC6B push 8000 ; nDenominator 

. text: 6EB9DC70 push ecx ; nNumerator 

. text: 6EB9DC71 push dword ptr [eax+4] ; nNumber 
.text:6EB9DC74 call ebx ; MulDiv(x,x,x) ; MulDiv(x,x,x) 
.text:6EB9DC76 add eax, [esi+74h] 

. text: 6EB9DC79 push 8000 ; nDenominator 

. text: 6EB9DC7E push dword ptr [edi+8] ; nNumerator 

. text: 6EB9DC81 mov [ebp+arg 8], eax 

. text: 6EB9DC84 mov eax, [ebp+arg 4] 

. text : 6EB9DC87 push dword ptr [eax] ; nNumber 

. text: 6EB9DC89 call ebx ; MulDiv(x,x,x) ; MulDiv(x,x,x) 
. text: 6EB9DC8B add eax, [esi+70h] 

. text: 6EB9DC8E mov ecx, [ebp«arg 0] 

.text:6EB9DC91 mov [ebp+var_8], eax 

. text: 6EB9DCI4 mov eax, [ebp«arg 8] 

.text:6EB9DC97 mov [ebp-var 4], eax 

. text : 6EB9DCIA lea eax, [ebp+var_8] 

. text: 6EB9DC9D push eax 

.text:6EB9DC9E lea eax, [ebp«var 10] 

.text:6EB9DCA1 push eax 

. text: 6EB9DCA2 push [ebp«arg C] 

. text: 6EB9DCA5 call ?DrawLine@Graphics@Gdiplus@@QAE? 7 


y AW4Status@2@PBVPen@2@ABVPoint@2@1@Z ; 
Gdiplus: :Graphics: :DrawLine(Gdiplus::Pen const *,Gdiplus::Point const 
&,Gdiplus::Point const &) 

. text: 6EBODCAA 

. text: 6EB9DCAA loc _6EB9DCAA: ; CODE XREF: 
CAnalogClock:: DrawHand(Gdiplus::Graphics *,int,ClockHand const 
&,Gdiplus::Pen *)+9B 


. text: 6EB9DCAA ; CAnalogClock:: DrawHand(Gdiplus::Graphics 
* int,ClockHand const &,Gdiplus::Pen *)+9F 

. text: 6EB9DCAA pop edi 

. text: 6EB9DCAB pop esi 

. text: 6EB9DCAC pop ebx 

. text: 6EB9DCAD leave 

. text: 6EB9DCAE retn 10h 


.text:6EB9DCAE ? DrawHand@CAnalogClock@@AAE? ^ 
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y AW4Status@GdiplLus@@PAVGraphics@3@HABUC LockHand@@PAVPen@3@@Z endp 
.text: 


6EB9DCAE 


We can see that DrawLine() arguments are dependent on result of MulDiv() function 
and a table[] table (name is mine), which has 8-byte elements (look at LEA's second 
operand). 


What is inside of table[]? 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
:6EB878B8 


.text 


.text: 
.text: 
.text: 
.text: 


6EB87890 ; int table[] 
6EB87890 table 
6EB87894 
6EB87898 
6EB8789C 
6EB878A0 
6EB878A4 
6EB878A8 
6EB878AC 
6EB878B0 
6EB878B4 


6EB878BC 
6EB878C0 
6EB878C4 
6EB878C8 


0 
OFFFFEOCIh 
344h 
OFFFFEOECh 
67Fh 
OFFFFE16Fh 
9A8h 
OFFFFE248h 
OCB5h 
OFFFFE374h 
OF9Fh 
OFFFFE4FOh 
125Eh 
OFFFFE6B8h 
14E9h 


It’s referenced only from DrawHand() function. It has 120 32-bit words or 60 32- 
bit pairs... wait, 60? Let's take a closer look at these values. First of all, I'll zap 
6 pairs or 12 32-bit words with zeros, and then l'Il put patched TIMEDATE.CPL into 
C:\WINDOWS\SYSTEM32. (You may need to set owner of the *TIMEDATE.CPL* file to 
your primary user account (instead of Trusted/nstaller), and also, boot in safe mode 


with command prompt so you can copy the file, which is usually locked.) 
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Monday, August 15, 2016 


Su Mo Tu We Th Fr Sa 
4 5 6 
11 12 13 
18 19 20 


25 26 27 NU 
i 2 3 I 
E a a n = A 


2:01:02 PM 


Change date and time settings... 


: > 2:01PM 
a qa) 165) 3/15/2016 ® 


Figure 8.11: Attempt to run 


Now when any hand is located at 0..5 seconds/minutes, it’s invisible! However, op- 
posite (shorter) part of second hand is visible and moving. When any hand is outside 
of this area, hand is visible as usual. 


Let’s take even closer look at the table in Mathematica. | have copypasted table 
from the TIMEDATE.CPL to a tbl file (480 bytes). We will take for granted the fact 
that these are signed values, because half of elements are below zero (OFFFFEOCIh, 
etc.). If these values would be unsigned, they would be suspiciously huge. 


In[]:= tbl = BinaryReadList["~/.../tbl", "Integer32"] 
Out[]= (0, -7999, 836, -7956, 1663, -7825, 2472, -7608, 3253, -7308, 3999, 7 


GN 
-6928, 4702, -6472, 5353, -5945, 5945, -5353, 6472, -4702, 6928, N 
-4000, 7308, -3253, 7608, -2472, 7825, -1663, 7956, -836, 8000, 0, \ 
7956, 836, 7825, 1663, 7608, 2472, 7308, 3253, 6928, 4000, 6472, N 
4702, 5945, 5353, 5353, 5945, 4702, 6472, 3999, 6928, 3253, 7308, N 
2472, 7608, 1663, 7825, 836, 7956, 0, 7999, -836, 7956, -1663, 7825, N 
-2472, 7608, -3253, 7308, -4000, 6928, -4702, 6472, -5353, 5945, \ 
-5945, 5353, -6472, 4702, -6928, 3999, -7308, 3253, -7608, 2472, N 
-7825, 1663, -7956, 836, -7999, 0, -7956, -836, -7825, -1663, -7608, \ 
-2472, -7308, -3253, -6928, -4000, -6472, -4702, -5945, -5353, -5353, \ 
-5945, -4702, -6472, -3999, -6928, -3253, -7308, -2472, -7608, -1663, \ 
-7825, -836, -7956} 


Length[tbl] 
120 


Let's treat two consecutive 32-bit values as pair: 


In[]:= pairs = Partition[tbl, 2] 

Out[]= {{0, -7999}, (836, -7956}, 11663, -7825}, (2472, -7608}, \ 
{3253, -7308}, {3999, -6928}, {4702, -6472}, {5353, -5945}, {5945, \ 
-5353}, {6472, -4702}, {6928, -4000}, {7308, -3253}, {7608, -2472}, \ 
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(7825, -1663}, (7956, -836}, (8000, 0}, (7956, 836}, (7825, 
1663}, (7608, 2472}, (7308, 3253}, (6928, 4000}, (6472, 

4702}, (5945, 5353}, (5353, 5945}, (4702, 6472), 13999, 

6928), (3253, 7308}, (2472, 7608), (11663, 7825}, (836, 7956}, (0, 
7999}, (-836, 7956}, {-1663, 7825}, {-2472, 7608}, {-3253, 

7308}, {-4000, 6928}, {-4702, 6472}, {-5353, 5945}, {-5945, 
5353}, {-6472, 4702}, {-6928, 3999}, {-7308, 3253}, {-7608, 
2472}, {-7825, 1663}, {-7956, 836}, {-7999, 

0}, {-7956, -836}, {-7825, -1663}, {-7608, -2472}, {-7308, -3253}, \ 
{-6928, -4000}, {-6472, -4702}, {-5945, -5353}, {-5353, -5945}, \ 
{-4702, -6472}, {-3999, -6928}, {-3253, -7308}, {-2472, -7608}, \ 
{-1663, -7825}, {-836, -7956}} 


In[]:= Length[pairs] 
Out[]= 60 


Let’s try to treat each pair as X/Y coordinate and draw all 60 pairs, and also first 15 
pairs: 
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Ini3:- ListPlot[pairs, AspectRatio > Full, ImageSize > (300, 300}] 
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Inf27)= ListPlot[pairs[[1;; 15]], AspectRatio >» Full, ImageSize > (300, 300}] 
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Figure 8.12: Mathematica 


Now this is something! Each pair is just coordinate. First 15 pairs are coordinates 
for + of circle. 


Perhaps, Microsoft developers precalculated all coordinates and put them into ta- 
ble. This is widespread, though somewhat old school practice - precalculated table 
access is faster than calling relatively slow sine/cosine functions?. Sine/cosine oper- 
ations are not that expensive anymore... 


Now | can understand why when | zapped first 6 pairs, hands were invisible at that 
area: in fact, hands were drawn, they just had zero length, because hand started at 


9Today this is known as memoization 
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0:0 coordinate and ended there. 


The prank (practical joke) 


Given all that, how would we force hands to go counterclockwise? In fact, this is 
simple, we need just to rotate the table, so each hand, instead of drawing at place 
of zeroth second, would be drawing at place of 59th second. 


| made the patcher a long time ago, at the very beginning of 2000s, for Windows 
2000. Hard to believe, it still works for Windows 7, perhaps, the table hasn't been 
changed since then! 


The patcher source code: https://beginners. re/paywall/RE4B- source/current-tree/ 
/examples/timedate/time pt.c. 


Now I can see all hands goes backwards: 


Saturday, August 13, 2016 


Su Mo Tu We Th 


9:32:09 AM 


Change date and time settings... 


A >) 9:32 AM 
O 8/13/2015 E 


Figure 8.13: Now it works 


Well, there is no animation in this book, but if you look closer, you can see, that 
hands are in fact shows correct time, but the whole clock face is rotated vertically, 
like we see it from the inside of clock. 


Windows 2000 leaked source code 


So | did the patcher and then Windows 2000 source code has been leaked (I can't 
force you to trust me, though). Let's take a look on source code if that function and 
table. 

The file is win2k/private/shell/cpls/utc/clock. c: 


// 

// Array containing the sine and cosine values for hand positions. 
// 

POINT rCircleTable[] = 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1038 


1 
{ 0, -7999}, 
{ 836, -7956}, 
{ 1663, -7825}, 
{ 2472, -7608}, 
{ 3253, -7308}, 
{ -4702, -6472}, 
{ -3999, -6928}, 
{ -3253, -7308}, 
{ -2472, -7608}, 
{ -1663, -7825}, 
{ -836 , -7956}, 

i 


AAA AAA AAA AAA AAA AAA AAA AAA AAA AAA AAA AAA AAA AAA AA AAA AAA AAA AAA EM 
/ / 

// DrawHand 

/ / 

// Draws the hands of the clock. 

/ / 

AAA AAA AAA AAA AAA AAA LLAU 


void DrawHand ( 
HDC hDC, 
int pos, 
HPEN hPen, 
int scale, 
int patMode, 
PCLOCKSTR np) 


LPPOINT lppt; 
int radius; 


MoveTo(hDC, np->clockCenter.x, np->clockCenter.y) ; 
radius = MulDiv(np->clockRadius, scale, 100); 

lppt = rCircleTable + pos; 

SetROP2(hDC, patMode) ; 

SelectObject(hDC, hPen); 


LineTo( hDC, 
np->clockCenter.x + MulDiv(lppt->x, radius, 8000), 
np->clockCenter.y + MulDiv(lppt->y, radius, 8000) ); 


Now it’s clear: coordinates has been precalculated as if clock face has height and 
width of 2- 8000, and then it’s rescaled to current clock face radius using MulDiv() 
function. 


POINT structure?? is a structure of two 32-bit values, first is x, second is y. 


10https://msdn.microsoft.com/en-us/library/windows/desktop/dd162805(v=vs.85) .aspx 
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8.6 (Windows 7) Solitaire: practical jokes 


8.6.1 51 cards 
This is a joke | did once for my coworkers who played a Solitaire game too much. | 
was wondering, if it’s possible to remove some cards, or maybe add (duplicates). 


| opened Solitaire.exe in IDA disassembler, which asked if to download PDB file for 
it from Microsoft servers. This is usually a rule for many Windows executables and 
DLLs. At least, PDB has all function names. 


Then I tried to find a 52 number in all functions (because this card game uses 52 
cards). As it turned out, only 2 functions has it. 


The first is: 


.text:00000001000393B4 ; | int64  fastcall SolitaireGame: :OnMoveComplete( 7 
y SolitaireGame *this) 
.text:00000001000393B4 ?0nMoveComplete@SolitaireGame@@QEAAHXZ proc near 


The second is the function with self-describing name (name pulled from PDB by IDA): 
InitialDeal(): 


.text:00000001000365F8 ; void _ fastcall SolitaireGame::InitialDeal(7 
S SolitaireGame * hidden this) 
.text:00000001000365F8 ?InitialDeal@SolitaireGame@@QEAAXXZ proc near 
.text:00000001000365F8 
.text:00000001000365F8 var 58 
.text:00000001000365F8 var 48 
.text:00000001000365F8 var 40 
.text:00000001000365F8 var 3C 
.text:00000001000365F8 var 38 
.text:00000001000365F8 var 30 
.text:00000001000365F8 var 28 
.text:00000001000365F8 var 18 
.text:00000001000365F8 
.text:00000001000365F8 ; FUNCTION CHUNK AT .text:00000001000A55C2 SIZE 7 
S 00000018 BYTES 
.text:00000001000365F8 


byte ptr -58h 
qword ptr -48h 
dword ptr -40h 
dword ptr -3Ch 
dword ptr -38h 
qword ptr -30h 
xmmword ptr -28h 
byte ptr -18h 


.text:00000001000365F8 ; | unwind ( //  CxxFrameHandler3 

.text:00000001000365F8 mov rax, rsp 

.text:00000001000365FB push rdi 

.text:00000001000365FC push r12 

.text:00000001000365FE push r13 

.text:0000000100036600 sub rsp, 60h 

.text:0000000100036604 mov [rsp+78h+var_48], 07 
S FFFFFFFFFFFFFFFEh 

.text:000000010003660D mov [rax+8], rbx 

.text:0000000100036611 mov [rax+10h], rbp 

. text :0000000100036615 mov [rax+18h], rsi 

. text :0000000100036619 movaps xmmword ptr [rax-28h], xmm6 

. text: 000000010003661D mov rsi, rcx 
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text:0000000100036620 xor edx, edx ; struct Y 
V Card * 

text:0000000100036622 call 27 
V SetSelectedCard@SolitaireGame@@QEAAXPEAVCard@@@Z ; SolitaireGame:: / 
V SetSelectedCard(Card *) 

text:0000000100036627 and qword ptr [rsi+0FOh], 0 

text:000000010003662F mov rax, cs:?7 
S g pSolitaireGamegQ3PEAVSolitaireGameQQGEA ; SolitaireGame * 7 
S g pSolitaireGame 

text:0000000100036636 mov rdx, [rax+48h] 

text: 000000010003663A cmp byte ptr [rdx«51h], 0 

text :000000010003663E jz short loc 10003664E 

text:0000000100036640 xor r8d, r8d ; bool 

text:0000000100036643 mov dl, 1 ; int 

text:0000000100036645 lea ecx, [r8+3] ; this 

text:0000000100036649 call 27 
y PlaySoundProto@GameAudio@@YA NH NPEAI@Z ; GameAudio: :PlaySoundProto( / 
4 int,bool,uint *) 

text :000000010003664E 

text:000000010003664E loc 10003664E: ; CODE XREF:Z 
G SolitaireGame: :InitialDeal(void)+46 

text :000000010003664E mov rbx, [rsi+88h] 

text:0000000100036655 mov r8d, 4 

text:000000010003665B lea rdx, aCardstackCreat ; "7 
y CardStack::CreateDeck()::uiNumSuits == "... 

text:0000000100036662 mov ebp, 10000h 

text:0000000100036667 mov ecx, ebp ; unsigned 7 
S int 

text:0000000100036669 call ?LOg@@YAXIPEBGZZ ; Log(uint, 7 
4 ushort const *,...) 

text :000000010003666E mov r8d, 52 poses 

text :0000000100036674 lea rdx, aCardstackCreat 0 ; "7 
\& CardStack::CreateDeck()::uiNumCards == "... 

text: 000000010003667B mov ecx, ebp ; unsigned 7 
G int 

text:000000010003667D call ?LOg@@YAXIPEBGZZ ; Log(uint, 7 
4 ushort const *,...) 

text :0000000100036682 xor edi, edi 

text:0000000100036684 loc 100036684: ; CODE XREF:Z 
G SolitaireGame: :InitialDeal(void)+C0O 

text :0000000100036684 mov eax, 4EC4EC4Fh 

text :0000000100036689 mul edi 

text :000000010003668B mov r8d, edx 

text: 000000010003668E shr red, 4 ; unsigned 7 
S int 

text:0000000100036692 mov eax, r8d 

text:0000000100036695 imul eax, 52 HELLE 

text:0000000100036698 mov edx, edi 

text:000000010003669A sub edx, eax ; unsigned 7 
4 int 

text:000000010003669C mov rcx, [rbx+128h] ; this 

text:00000001000366A3 call 27 
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V CreateCard@CardTable@@IEAAPEAVCard@@II@Z ; CardTable::CreateCard(uint/ 
S ,uint) 
.text:00000001000366A8 mov rdx, rax ; struct Y 
V Card * 
.text:00000001000366AB mov rcx, rbx ; this 
.text:00000001000366AE call 27 
y Push@CardStack@@QEAAXPEAVCard@@@Z ; CardStack: :Push(Card *) 
.text:00000001000366B3 inc edi 
.text:00000001000366B5 cmp edi, 52 poses 
. text :00000001000366B8 jb short loc 100036684 
.text:00000001000366BA xor r8d, r8d ; bool 
.text:00000001000366BD xor edx, edx ; bool 
.text:00000001000366BF mov rcx, rbx ; this 
.text:00000001000366C2 call 27 
y Arrange@CardStack@@QEAAX NO@Z ; CardStack: :Arrange(bool, bool) 
. text :00000001000366C7 mov r13, [rsi+88h] 
. text :00000001000366CE lea rdx, aCardstackShuff ; "7 
y CardStack::Shuffle()" 
.text:00000001000366D5 mov ecx, ebp ; unsigned 7 
S int 
.text:00000001000366D7 call ?LOg@@YAXIPEBGZZ ; Log(uint, ? 
4 ushort const *,...) 
.text:00000001000366DC and [rsp+78h+var_ 40], 0 
. text :00000001000366E1 and [rsp+78h+var_ 3C], 0 
. text :00000001000366E6 mov [rsp+78h+var_38], 10h 
. text :00000001000366EE xor ebx, ebx 
. text :00000001000366F0 mov [rsp+78h+var_30], rbx 


Anyway, we clearly see a loop of 52 iterations. A loop body has calls to CardTable()::CreateCard() 
and CardStack: :Push(). 


The CardTable: :CreateCard() eventually calls Card: :Init() with values in 0..51 
range, as one of its arguments. This can be easily checked using debugger. 


So I tried just to change the 52 (0x34) number to 51 (0x33) in the cmp edi, 52 in- 
struction at 0x1000366B5 and run it. At first glance, nothing happened, but I noticed 
that now it's hard to solve the game. | spent almost an hour to reach this position: 
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Game Help 


Ace of hearts is missing. Perhaps, internally, this card is numbered as 51th (if to 
number them from zero). 


In the other place I found all card names. Maybe names to be used to fetch card 
graphics from resources? 


.data:00000001000B6970 ?CARD NAME@Card@@2PAPEBGA dq offset aTwoofclubs 


.data:00000001000B6970 7 "2 
S TwoOfClubs" 

.data:00000001000B6978 dq offset aThreeofclubs ; "7 
S ThreeOfClubs" 

.data:00000001000B6980 dq offset aFourofclubs ; "7 
V FourOfClubs" 

.data:00000001000B6988 dq offset aFiveofclubs ; "7 
V FiveOfClubs" 

.data:00000001000B6990 dq offset aSixofclubs Eom 
y SixOfClubs" 

.data:00000001000B6998 dq offset aSevenofclubs ; "7 
V SevenOfClubs" 

.data:00000001000B69A0 dq offset aEightofclubs ; "7 
S EightOfClubs" 

.data:00000001000B69A8 dq offset aNineofclubs ; "7 
y NineOfClubs" 

.data:00000001000B69B0 dq offset aTenofclubs TP. 


S TenOfClubs" 
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emails. Thanks! 


.data:00000001000B69B8 dq offset aJackofclubs ; "7 
y JackOfClubs" 

.data:00000001000B69C0 dq offset aQueenofclubs ; "7 
S QueenOfClubs" 

.data:00000001000B69C8 dq offset aKingofclubs ; "7 
y KingOfClubs" 

.data:00000001000B69D0 dq offset aAceofclubs p "2 
S AceOfClubs" 

.data:00000001000B69D8 dq offset aTwoofdiamonds ; "7 
S TwoOfDiamonds" 

.data:00000001000B69E0 dq offset aThreeofdiamond ; "7 
S ThreeOfDiamonds" 

.data:00000001000B69E8 dq offset aFourofdiamonds ; "7 
s FourOfDiamonds" 

.data:00000001000B69F0 dq offset aFiveofdiamonds ; "7 
V FiveOfDiamonds" 

.data:00000001000B69F8 dq offset aSixofdiamonds ; "7 
y SixOfDiamonds" 

.data:00000001000B6A00 dq offset aSevenofdiamond ; "7 
S SevenOfDiamonds" 

.data:00000001000B6A08 dq offset aEightofdiamond ; "7 
S EightOfDiamonds" 

.data:00000001000B6A10 dq offset aNineofdiamonds ; "7 
S NineOfDiamonds" 

.data:00000001000B6A18 dq offset aTenofdiamonds ; "7 
S TenOfDiamonds" 

.data:00000001000B6A20 dq offset aJackofdiamonds ; "7 
V JackOfDiamonds" 

.data:00000001000B6A28 dq offset aQueenofdiamond ; "7 
S QueenOfDiamonds" 

.data:00000001000B6A30 dq offset aKingofdiamonds ; "7 
S KingOfDiamonds" 

.data:00000001000B6A38 dq offset aAceofdiamonds ; "7 
S AceOfDiamonds" 

.data:00000001000B6A40 dq offset aTwoofspades ; "7 
S TwoOfSpades" 

.data:00000001000B6A48 dq offset aThreeofspades ; "7 
S ThreeOfSpades" 

.data:00000001000B6A50 dq offset aFourofspades ; "7 
V FourOfSpades" 

.data:00000001000B6A58 dq offset aFiveofspades ; "7 
\ FiveOfSpades" 

.data:00000001000B6A60 dq offset aSixofspades ; "7 
V SixOfSpades" 

.data:00000001000B6A68 dq offset aSevenofspades ; "7 
V SevenOfSpades" 

.data:00000001000B6A70 dq offset aEightofspades ; "7 
y EightOfSpades" 

.data:00000001000B6A78 dq offset aNineofspades ; "7 
S NineOfSpades" 

.data:00000001000B6A80 dq offset aTenofspades ; "7 
V TenOfSpades" 

.data:00000001000B6A88 dq offset aJackofspades ; "7 
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y JackOfSpades" 
.data:00000001000B6A90 dq offset aQueenofspades ; "7 
S QueenOfSpades" 
.data:00000001000B6A98 dq offset aKingofspades ; "7 
S KingOfSpades" 
.data:00000001000B6AA0 dq offset aAceofspades ; "7 
ú AceOfSpades" 
.data:00000001000B6AA8 dq offset aTwoofhearts ; "7 
S TwoOfHearts" 
.data:00000001000B6ABO dq offset aThreeofhearts ; "7 
S ThreeOfHearts" 
.data:00000001000B6AB8 dq offset aFourofhearts ; "7 
V FourOfHearts" 
.data:00000001000B6ACO dq offset aFiveofhearts ; "7 
V FiveOfHearts" 
.data:00000001000B6AC8 dq offset aSixofhearts ; "7 
V SixOfHearts" 
.data:00000001000B6ADO dq offset aSevenofhearts ; "7 
S SevenOfHearts" 
.data:00000001000B6AD8 dq offset aEightofhearts ; "7 
S EightOfHearts" 
.data:00000001000B6AE0 dq offset aNineofhearts ; "7 
S NineOfHearts" 
.data:00000001000B6AE8 dq offset aTenofhearts ; "7 
S TenOfHearts" 
.data:00000001000B6AF0 dq offset aJackofhearts ; "7 
s JackOfHearts" 
.data:00000001000B6AF8 dq offset aQueenofhearts ; "7 
S QueenOfHearts" 
.data:00000001000B6B00 dq offset aKingofhearts ; "7 
y KingOfHearts" 
.data:00000001000B6B08 dq offset aAceofhearts ; "7 
V AceOfHearts" 
.data:00000001000B6B10 ; public: static unsigned short const * near * Cardz 
V ::CARD HUMAN NAME 
.data:00000001000B6B10 ?CARD HUMAN NAME@Card@@2PAPEBGA dq offset 2 
s a54639Cardnames 
.data:00000001000B6B10 ; "|54639| 2 
y CardNames|Two Of Clubs" 
.data:00000001000B6B18 dq offset a64833Cardnames ; "|64833|7 
s CardNames|Three Of Clubs" 
.data:00000001000B6B20 dq offset a62984Cardnames ; "|62984|7 
y CardNames|Four Of Clubs" 
.data:00000001000B6B28 dq offset a65200Cardnames ; "|65200|7 
y CardNames|Five Of Clubs" 
.data:00000001000B6B30 dq offset a52967Cardnames ; "|52967|7 
y CardNames|Six Of Clubs" 
.data:00000001000B6B38 dq offset a42781Cardnames ; "|42781|7 
y CardNames|Seven Of Clubs" 
.data:00000001000B6B40 dq offset a49217Cardnames ; "|49217|7 
s CardNames|Eight Of Clubs" 
.data:00000001000B6B48 dq offset a44682Cardnames ; "|44682|7 
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y CardNames|Nine Of Clubs" 

data:00000001000B6B50 dq offset a51853Cardnames ; "|51853|7 
y CardNames|Ten Of Clubs" 

data:00000001000B6B58 dq offset a46368Cardnames ; "|46368|7 
y CardNames|Jack Of Clubs" 

data:00000001000B6B60 dq offset a61344Cardnames ; "|61344|7 
s CardNames |Queen Of Clubs" 

data:00000001000B6B68 dq offset a65017Cardnames ; "|65017| 
s CardNames|King Of Clubs" 

data:00000001000B6B70 dq offset a57807Cardnames ; "|57807| 
y CardNames Ace Of Clubs" 

data:00000001000B6B78 dq offset a48455Cardnames ; "|48455|7 
y CardNames|Two Of Diamonds" 

data:00000001000B6B80 dq offset a44156Cardnames ; "|44156|7 
\ CardNames|Three Of Diamonds" 

data:00000001000B6B88 dq offset a51672Cardnames ; "|51672|7 
y CardNames|Four Of Diamonds" 

data: 00000001000B6B90 dq offset a45972Cardnames ; "|45972| 
y CardNames|Five Of Diamonds" 

data:00000001000B6B98 dq offset a47206Cardnames ; "|47206|7 
y CardNames|Six Of Diamonds" 

data:00000001000B6BA0 dq offset a48399Cardnames ; "|48399|7 
s CardNames |Seven Of Diamonds" 

data:00000001000B6BA8 dq offset a47847Cardnames ; "|47847|7 
S CardNames|Eight Of Diamonds" 

data:00000001000B6BBO dq offset a48606Cardnames ; "|48606|7 
y CardNames |Nine Of Diamonds" 

data:00000001000B6BB8 dq offset a61278Cardnames ; "|61278|7 
y CardNames|Ten Of Diamonds" 

data:00000001000B6BCO dq offset a52038Cardnames ; "|52038|7 
y CardNames|Jack Of Diamonds" 

data:00000001000B6BC8 dq offset a54643Cardnames ; "|54643|7 
\ CardNames |Queen Of Diamonds" 

data:00000001000B6BDO dq offset a48902Cardnames ; "|48902|^ 
\ CardNames|King Of Diamonds" 

data:00000001000B6BD8 dq offset a46672Cardnames ; "|46672|7 
S CardNames |Ace Of Diamonds" 

data:00000001000B6BEO dq offset a41049Cardnames ; "|41049|7 
y CardNames|Two Of Spades" 

data:00000001000B6BE8 dq offset a49327Cardnames ; "|49327| 
y CardNames|Three Of Spades" 

data: 00000001000B6BF0 dq offset a51933Cardnames ; "|51933|7 
y CardNames|Four Of Spades" 

data:00000001000B6BF8 dq offset a42651Cardnames ; "|42651| 
«S CardNames|Five Of Spades" 

data:00000001000B6C00 dq offset a65342Cardnames ; "|65342|7 
\ CardNames|Six Of Spades" 

data: 00000001000B6C08 dq offset a53644Cardnames ; "|53644|7 
\ CardNames Seven Of Spades" 

data: 00000001000B6C10 dq offset a54466Cardnames ; "|54466|7 
S CardNames |Eight Of Spades" 

data: 00000001000B6C18 dq offset a56874Cardnames ; "|56874|7 
«S CardNames|Nine Of Spades" 
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00000001000B6C20 
CardNames|Ten Of Spades" 
00000001000B6C28 
CardNames|Jack Of Spades" 
00000001000B6C30 
CardNames|Queen Of Spades" 
00000001000B6C38 
CardNames|King Of Spades" 
00000001000B6C40 
CardNames|Ace Of Spades" 
00000001000B6C48 
CardNames|Two Of Hearts" 
00000001000B6C50 
CardNames|Three Of Hearts" 
00000001000B6C58 
CardNames|Four Of Hearts" 
00000001000B6C60 
CardNames|Five Of Hearts" 
00000001000B6C68 
CardNames|Six Of Hearts" 
00000001000B6C70 
CardNames|Seven Of Hearts" 
00000001000B6C78 
CardNames|Eight Of Hearts" 
00000001000B6C80 
CardNames|Nine Of Hearts" 
00000001000B6C88 
CardNames|Ten Of Hearts" 
00000001000B6C90 
CardNames|Jack Of Hearts" 
00000001000B6C98 
CardNames|Queen Of Hearts" 
00000001000B6CAO 
CardNames|King Of Hearts" 
00000001000B6CA8 
CardNames|Ace Of Hearts" 


dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 
dq 


dq 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


offset 


a46756Cardnames ; 


a62876Cardnames ; 


a64633Cardnames ; 


a46215Cardnames ; 


a60450Cardnames ; 


a51010Cardnames ; 


a64948Cardnames ; 


a43079Cardnames ; 


a57131Cardnames ; 


a58953Cardnames ; 


a45105Cardnames ; 


a47775Cardnames ; 


a41825Cardnames ; 


a41501Cardnames ; 


a47108Cardnames ; 


a55659Cardnames ; 


a44572Cardnames ; 


a44183Cardnames ; 


"146756 | 2 
"162876 | 2 
"164633 | 2 
"146215 | 2 
"160450 | 2 
"151010 | 2 
"164948 | 2 
"143079 | 2 
"157131| 2 
"158953 | 2 
"145105 | 2 
"147775 | 7 
"141825 | 7 
"141501| 2 
"147108 | 7 
"155659 | 2 
"144572 7 


"144183 | 2 


If you want to do this to someone, be sure his/her mental health is stable. 


Aside of function names from PDB file, there are lots of Log() function calls that 
can help significantly, because the Solitaire game reports about what it’s doing right 


now. 


Homework: try to remove several cards or two of clubs. And what if to swap card 
names in arrays of strings? 


| also tried to pass a numbers like O, 0..50 to Card: Init() (so to have 2 zeroes in a 
list of 52 numbers). Then | saw two two of clubs cards at one moment, but Solitaire 
behaves erratically. 


This is patched Windows 7 Solitare: Solitaire51.exe. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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8.6.2 53 cards 


Now take a look on the first part of the loop: 


.text:0000000100036684 loc 100036684: ; CODE XREF:2 
y SolitaireGame: :InitialDeal(void)+1C0j 
. text :0000000100036684 mov eax, 4EC4EC4Fh 
. text :0000000100036689 mul edi 
. text :000000010003668B mov r8d, edx 
. text :000000010003668E shr rad, 4 ; unsigned 7 
4 int 
.text:0000000100036692 mov eax, r8d 
.text:0000000100036695 imul eax, 52 
.text:0000000100036698 mov edx, edi 
.text:000000010003669A sub edx, eax ; unsigned 7 
S int 
.text:000000010003669C mov rcx, [rbx+128h] ; this 
.text:00000001000366A3 call 27 
V CreateCard@CardTable@@IEAAPEAVCard@@II@Z ; CardTable::CreateCard(uint/ 
S ,uint) 
.text:00000001000366A8 mov rdx, rax ; struct Y 
y Card * 
.text:00000001000366AB mov rcx, rbx ; this 
.text:00000001000366AE call 27 
y Push@CardStack@@QEAAXPEAVCard@@@Z ; CardStack: :Push(Card *) 
.text:00000001000366B3 inc edi 
.text:00000001000366B5 cmp edi, 52 
.text:00000001000366B8 jb short loc 100036684 


What is with multiplication by 4ECAECAFh? Surely, this is division by multiplication. 
And what Hex-Rays can say: 


v5 = 0; 
do 


v6 = CardTable: :CreateCard(v4[37], v5 % 0x34, v5 / 0x34); 
CardStack: :Push((CardStack *)v4, v6); 
++V5; 

} 

while ( v5 < 0x34 ); 


Somehow, CreateCard() functions takes two arguments: iterator divided by 52 and 
a remainder of the division operation. Hard to say, why they did so. Solitaire can’t 
allow more than 52 cards, so the last argument is senseless, it’s always zero. 


But when | patch cmp edi, 52 instruction at 0x1000366B5 to be cmp edi, 53, | 
found that there are now 53 cards. The last one is two of clubs, because it’s num- 
bered as Oth card. 


During the last iteration, 0x52 is divided by 0x52, remainder is zero, so Oth card is 
added twice. 


What a frustration, there are two two of clubs: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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This is patched Windows 7 Solitare: Solitaire53. 


8.7 FreeCell prank (Windows 7) 


This is a prank | once played for my coworkers who played FreeCell solitaire too much. 
Can we make FreeCell always deal the same game each time? Like, you know, in 
“Groundhog Day” movie? 


(I’m writing this in November 2019. Somehow, IDA can't get PDBs from Microsoft 
servers. Maybe Windows 7 is unsupported anymore? Anyway, | can't get function 
names...) 


8.7.1 Part! 


So I loaded FreeCell.exe into IDA and found that both rand(), srand() and time() are 
imported from msvcrt.dll. time() is indeed used as a seed for srand(): 


| text :01029612 sub 1029612 proc near ; CODE | 
XREF: sub 102615C«149 

| text :01029612 ; 
sub 1029DA6+67 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
:01029621 


.text 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 

XREF: 
.text: 

sub 1029612+2D 
.text: 
.text: 
:01029638 


. text 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


01029612 
01029614 
01029615 
01029616 
01029618 
0102961A 
01029620 


01029627 
0102962D 
0102962E 
0102962F 
01029631 
01029633 
01029633 


01029633 


01029633 
01029635 


0102963A 
0102963F 
01029641 
01029643 
01029644 
01029646 
0102964B 
0102964C 
0102964D 
0102964D 


FF 


FF 


00 
F9 
15 80 16 00+ 


15 84 16 00+ 
35 AC 16 00+ 


D6 
D6 


sub 1029612426 


40 42 OF 00 
F2 
01 


CF 
2D F8 FF FF 


loc 1029633: 


sub 1029612 


mov 
push 
push 
push 
mov 
call 
push 
call 
mov 
pop 
pop 
call 
call 


edi, edi 
esi 

edi 

0 

edi, ecx 
ds:time 
eax 
ds:srand 
esi, ds:rand 
ecx 

ecx 

esi ; rand 
esi ; rand 


esi ; rand 
eax, 1 


, 


, 


, 


short loc_1029633 


eax, 1000000 


short loc_1029633 


1 

eax 

ecx, edi 
sub 1028E78 
edi 

esi 


; Time 


; Seed 


; CODE 


Several (redundant) calls to rand() are funny, that reminds me: 


“In the morning you will send for a hansom, desiring your man to take neither the 
first nor the second which may present itself." ( The Memoirs of Sherlock Holmes, 
by Arthur Conan Doyle?! ) 


There is another call of time() and srand() pair, but my tracer showed that this is the 
point of our interest: 


tracer.exe -l:FreeCell.exe bpf=msvcrt.dll!time bpf=msvcrt.dll!srand,args:1 


TID-5340|(0) msvcrt.dll!time() (called from FreeCell.exe!BASE+0x29620 (07 


4 x209620)) 
TID-5340| (0) 
TID-5340| (1) 

4 X29627 
TID-5340| (1) 
TID-5340| (1) 

y x27d3a 


msvcrt.dli!time() 
msvcrt.dll!srand(0x5ddb68aa) 
(0x209627)) 

msvcrt.dli!srand() 
msvcrt.dli!srand(0x399f) 
(0x207d3a)) 


-> 0x5ddb68aa 


Hhttp://www.gutenberg.org/files/834/834-0.txt 


-» 0x5507e0 
(called from FreeCell.exe! BASE+0 7 


(called from FreeCell. exe! BASE+0 7 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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TID-5340|(1) msvcrt.dll!srand() -» 0x5507e0 


You see, the time() function returned 0x5ddb68aa and the very same value is used 
as an argument for srand(). 


Let's try to force time() to always return 0: 


tracer.exe -l:FreeCell.exe bpfemsvcrt.dll!time,rt:0 bpfemsvcrt.dll!srand,7 
V args:1 


TID=2104| (0) msvcrt.dll!time() (called from FreeCell.exe!BASE+0x29620 (07 
S xb19620)) 

TID-2104|(0) msvcrt.dll!time() -> Ox5ddb68f6 

TID-2104|(0) Modifying EAX register to 0x0 

TID-2104|(1) msvcrt.dll!srand(0x0) (called from FreeCell.exe!BASE+0x29627 7 
y (0xb19627)) 

TID=2104| (1) msvcrt.dll!srand() -> 0x3707e0 

TID-2104|(1) msvcrt.dll!srand(0x52f6) (called from FreeCell.exe! BASE+0/ 
S x27d3a (0xb17d3a)) 

TID-2104|(1) msvcrt.dll!srand() -> 0x3707e0 


Now I’m seeing the same game each time I’m running FreeCell using tracer: 


E 


Game Help 


#21238 


[Cards left: 52 a 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Now how to patch the executable? 


We want to pass 0 as an argument to srand() at 0x01029620. But there is a one-byte 
instruction: PUSH EAX. PUSH 0 is two-byte instruction. How to squeeze it into? 


What is in other registers at this moment? Using tracer I’m dumping all them: 


tracer.exe -l:FreeCell.exe bpx=FreeCell.exe!0x01029620 


TID=4448| (0) FreeCell.exe!0x1029620 

EAX=0x5ddb6ac4 EBX=0x00000000 ECX=0x00000000 EDX=0x00000000 
ESI=0x054732d0 EDI=0x054732d0 EBP=0x0020f2bc ESP=0x0020f298 
EIP-0x00899620 

FLAGS=PF ZF IF 

TID=4448| (0) FreeCell.exe!0x1029620 

EAX=0x5ddb6ac8 EBX=0x00000002 ECX=0x00000000 EDX=0x00000000 
EST=0xffffff11 EDI=0x054732d0 EBP=0x0020da78 ESP=0x0020d9d4 
EIP-0x00899620 

FLAGS-PF ZF IF 

TID=4448| (0) FreeCell.exe!0x1029620 

EAX-0x5ddb6aca EBX=0x00000002 ECX=0x00000000 EDX=0x00000000 
ESI=0x7740c460 EDI=0x054732d0 EBP=0x0020da78 ESP=0x0020d9d4 
EIP=0x00899620 

FLAGS=PF ZF IF 


No matter how often | restart the game, ECX and EDX are seems to be always 0. So | 
patching PUSH EAX at 0x01029620 to PUSH EDX (also one-byte instruction), and now 
FreeCell always shows the same game to the player. 


However, other options could exist. As a matter of fact, we don’t need to pass 0 to 
srand(). Rather, we want to pass a constant to srand() to make game the same each 
time. As we can see, EDI's value hasn't been changing. Maybe we could try it as 
well. 


Now a bit harder patching. Let's open FreeCell.exe in Hiew: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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FF] Hiew: FreeCelLexe 


C:\tmp\FreeCell.exe 


.01029612: 8BFF mov edi, edi 
.01029614: 56 push esi 
.01029615: 57 push edi 
.01029616: 6A00 push 

.01029618: 8BF9 mov edi,ecx 
.0102961A: FF15 call time 
.01029620: 50 push eax 
.01029621: FF15 call srand 
.01029627: 8B35 mov esi,rand --B 
.0102962D: 59 pop ecx 
.0102962E: 59 pop ecx 
.0102962F: call esi 
.01029631: call esi 
.01029633: call esi 


We have no space to replace one-byte PUSH EAX with two-byte PUSH 0. And we can't 
simply fill CALL ds:time with NOPs, because there is a FIXUP (address of time() 
function in msvcrt.dll). (Hiew marked these 4 bytes are gray bytes.) So what I’m 
doing: patching first 2 bytes to EB 04. This is a JMP to bypass 4 FIXUP-ed bytes: 


FF] Hiew: FreeCelLexe 


.01029612: edi,edi 
.01029614: esi 
.01029615: edi 
.01029616: 

.01029618: edi,ecx 
.0102961A: j --B 


.0102961C: b,[esil, 

.0102961F: [eax] [0168415FF ] , edx 
.01029625: [ecx],al 

- 91029627: esi,rand --B 
.0102962D: 

.0102962E: 

.0102962F: 


Then | replace PUSH EAX with NOP. So that srand() would have its zeroes arguments 
from PUSH 0 above. Also, | patch one of POP ECX to NOP, because | removed one 
PUSH. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1053 


Hiew: FreeCell.exe 


Now Windows loader will write 4-byte FIXUP at 0x0102961C, but we don't care: 
time()'s address will not be used anymore. 


8.7.2 Part Il: breaking the Select Game submenu 


The user can still choose different game in the menu. Let's see if srand() is still called. 
I’m trying to enter 1/2/3 in "Select Game" dialog box: 


tracer.exe -l:FreeCell.exe bpf=msvcrt.dll!srand,args:1 


TID=4936| (0) msvcrt.dll!srand(Ox5ddb6df9) (called from FreeCell.exe!BASE«07 
S x29627 (0xb49627)) 

TID=4936|(0) msvcrt.dll!srand() -» 0x5907e0 

TID=4936| (0) msvcrt.dll!srand(0x2b40) (called from FreeCell.exe! BASE+0/ 
S x27d3a (0xb47d3a)) 

TID-4936|(0) msvcrt.dll!srand() -> 0x5907e0 

TID=4936| (0) msvcrt.dll!srand(0x1) (called from FreeCell.exe!BASE+0x27d3a 7 
y (0xb47d3a)) 

TID=4936| (0) msvcrt.dll!srand() -> 0x5907e0 

TID=4936| (0) msvcrt.dll!srand(0x2) (called from FreeCell.exe!BASE+0x27d3a 7 
y (0xb47d3a)) 

TID=4936|(0) msvcrt.dll!srand() -> 0x5907e0 

TID=4936| (0) msvcrt.dll!srand(0x3) (called from FreeCell.exe!BASE+0x27d3a 7 
y (0xb47d3a)) 

TID=4936|(0) msvcrt.dll!srand() -> 0x5907e0 


Yes, the number user enters is just an argument for srand(). Where it is called? 


.text:01027CBA loc 1027CBA: i 2 
\ CODE XREF: subx_1027AC6+179 

.text:01027CBA 83 FF FC cmp edi, OFFFFFFFCh 

.text:01027CBD 75 74 jnz short loc 1027D33 

.text:01027D33 loc 1027D33: y 


\ CODE XREF: sub\_1027AC6+1F7 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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.text:01027D33 57 push edi $^ 
S Seed 

.text:01027D34 FF 15 84 16 00+ call ds:srand 

.text:01027D3A 59 pop ecx 

.text:01027D3B 6A 34 push 34h 

.text:01027D3D 5B pop ebx 

.text:01027D3E 33 CO xor eax, eax 


| couldn't patch one-byte PUSH EDI to two-byte PUSH 0. But | see that there is only 
one single jump to Loc 1027D33 from the above. 


I’m patching CMP EDI, ... to XOR EDI, EDI, padding the 3rd byte to NOP. I'm 
patching also JNZ to JMP, so that jump will always occur. 


Now FreeCell ignores the number user enters, but suddenly, there is also the same 
game at start: 


AE 


It seems that the code we patched in part | is somehow connected to a code after 
0x01027CBD, that executes if EDI==OxFFFFFFFC. Anyway, our goal is accomplished 
— the game is always the same at the start and the user can't choose another using 
the menu. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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8.8 Dongles 
The author of these lines, occasionally did software copy-protection dongle replace- 
ments, or "dongle emulators" and here are couple examples of how it's happening. 


About one of the cases about Rocket and Z3 that is not present here, you can read 
here: http://yurichev.com/tmp/SAT SMT DRAFT.pdf. 


8.8.1 Example £1: MacOS Classic and PowerPC 


Here is an example of a program for MacOS Classic ??, for PowerPC. The company 
who developed the software product has disappeared a long time ago, so the (legal) 
customer was afraid of physical dongle damage. 


While running without a dongle connected, a message box with the text "Invalid 
Security Device" appeared. 


Luckily, this text string could easily be found in the executable binary file. 


Let's pretend we are not very familiar both with Mac OS Classic and PowerPC, but 
will try anyway. 

IDA opened the executable file smoothly, reported its type as "PEF (Mac OS or Be 
OS executable)" (indeed, it is a standard Mac OS Classic file format). 


By searching for the text string with the error message, we've got into this code 
fragment: 


seg000:000C87FC 38 60 00 01 li *r3, 1 

seg000:000C8800 48 03 93 41 bl check1 

seg000:000C8804 60 00 00 00 nop 

seg000:000C8808 54 60 06 3F  clrlwi. %r0, %r3, 24 

seg000:000C880C 40 82 00 40 bne OK 

seg000:000C8810 80 62 9F D8 lwz *r3, TC aInvalidSecurityDevice 


Yes, this is PowerPC code. 
The CPU is a very typical 32-bit RISC of 1990s era. 


Each instruction occupies 4 bytes (just as in MIPS and ARM) and the names somewhat 
resemble MIPS instruction names. 


check1() is a function name we'll give to it later. BL is Branch Link instruction, e.g., 
intended for calling subroutines. 


The crucial point is the BNE instruction which jumps if the dongle protection check 
passes or not if an error occurs: then the address of the text string gets loaded into 
the r3 register for the subsequent passing into a message box routine. 


125re-UNIX MacOS 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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From the [Steve Zucker, SunSoft and Kari Karhi, IBM, SYSTEM V APPLICATION BINARY 
INTERFACE: PowerPC Processor Supplement, (1995)]'?we will found out that the r3 
register is used for return values (and r4, in case of 64-bit values). 


Another yet unknown instruction is CLRLWI. From [PowerPC(tm) Microprocessor Fam- 
ily: The Programming Environments for 32-Bit Microprocessors, (2000)]!^we'll learn 
that this instruction does both clearing and loading. In our case, it clears the 24 
high bits from the value in r3 and puts them in rO, so it is analogical to MOVZX in x86 
(1.23.1 on page 255), but it also sets the flags, so BNE can check them afterwards. 


Let's take a look into the check1() function: 


seg000:00101B40 check1: # CODE XREF: seg000:00063E7Cp 
seg000:00101B40 # sub 64070+160p ... 
seg000:00101B40 

seg000:00101B40 .set arg 8, 8 

seg000:00101B40 

seg000:00101B40 7C 08 02 A6 mflr %rQ 

seg000:00101B44 90 01 00 08 stw *sr0, arg 8(%sp) 
seg000:00101B48 94 21 FF CO stwu “sp, -0x40(%sp) 
seg000:00101B4C 48 01 6B 39 bl check2 
seg000:00101B50 60 00 00 00 nop 

seg000:00101B54 80 01 00 48 lwz %r0, 0x40+arg_8(%sp) 
seg000:00101B58 38 21 00 40 addi %Sp, %sp, 0x40 
seg000:00101B5C 7C 08 03 A6 mtlr *srO 

seg000:00101B60 4E 80 00 20 blr 

seg000:00101B60 # End of function checkl 


As you can see in IDA, that function is called from many places in the program, but 
only the r3 register’s value is checked after each call. 


All this function does is to call the other function, so it is a thunk function: there 
are function prologue and epilogue, but the r3 register is not touched, so checkl() 
returns what check2() returns. 


BLR?? looks like the return from the function, but since IDA does the function layout, 
we probably do not need to care about this. 


Since it is a typical RISC, it seems that subroutines are called using a link register, 
just like in ARM. 


The check2() function is more complex: 


seg000:00118684 check2: # CODE XREF: check1+Cp 
seg000:00118684 

seg000:00118684 .set var 18, -0x18 
seg000:00118684 .set var C, -0xC 
seg000:00118684 .set var 8, -8 

seg000:00118684 .set var 4, -4 

seg000:00118684 .set arg 8, 8 


seg000:00118684 


l13Also available as http://yurichev.com/mirrors/PowerPC/elfspec ppc.pdf 
1^Also available as http://yurichev.com/mirrors/PowerPC/6xx pem.pdf 
15(PowerPC) Branch to Link Register 
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seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 
seg000 


100118684 
100118688 
:0011868C 
160118690 
100118690 
100118694 
100118698 
:0011869C 
:001186A0 
:001186A4 
:001186A8 
:001186AC 
:001186B0 
:001186B4 
:001186B8 
:001186B8 
:001186B8 
:001186BC 
:001186C0 
:001186C4 
:001186C4 
:001186C4 
:001186C8 
:001186CC 
:001186D0 
:001186D4 
:001186D8 
:001186DC 
:001186E0 
:001186E0 
:001186E0 
:001186E4 
:001186E8 
:001186EC 
:001186F0 
:001186F4 
:001186F8 
:001186F8 
:001186F8 
:001186FC 
:00118700 
:00118704 
:00118708 
:00118708 
:00118708 
:0011870C 
:00118710 
:00118714 
:00118718 
:0011871C 
:00118720 
:00118720 
:00118720 


stw *sr31, var_4(%sp) 

mflr ?srO 

lwz %r31, off 1485E8 + dword 24B704 
.using dword 24B704, %r31 

stw *sr30, var_8(%sp) 

stw *sr29, var_C(%sp) 

mr %r29, %r3 

stw *sr0, arg_8(%sp) 


clrlwi %r0, %r3, 24 
cmplwi %r0, 1 


stwu “sp, -0x50(%sp) 
bne loc_1186B8 
li %r3, 1 
b exit 
loc 1186B8: # CODE XREF: check2+28j 
bl sub 118A8C 
nop 
li %r30, 0 
skip: # CODE XREF: check2+94j 
clrlwi. %r0, %r30, 24 
beq loc_1186E0 
addi %r3, %sp, Ox50+var_18 
lwz *sr4, dword_24B704 
bl . RBEFINDNEXT 
nop 
b loc_1186F8 
loc 1186E0: # CODE XREF: check2+44j 
lwz %r5, dword_24B704 
addi %r4, “sp, Ox50+var_18 
li %r3, 0x1234 
bl . RBEFINDFIRST 
nop 
li %r30, 1 


loc_1186F8: # CODE XREF: check2+58j 


clrlwi. %r0, %r3, 16 

beq must_jump 

li ?sr3, 0 # error 
b exit 


must jump: # CODE XREF: check2+78j 


mr %r3, %r29 
bl check3 
nop 
clrlwi. %r0, %r3, 24 
beq skip 
li %r3, 1 
exit: # CODE XREF: check2+30j 


# check2+80j 
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seg000:00118720 80 01 00 58  lwz *sr0, Ox50+arg_8(%sp) 
seg000:00118724 38 21 00 50 addi “sp, “sp, 0x50 
seg000:00118728 83 El FF FC lwz *sr31, var_4(%sp) 
seg000:0011872C 7C 08 03 A6  mtlr %rQ 

seg000:00118730 83 C1 FF F8 lwz *sr30, var_8(%sp) 
seg000:00118734 83 Al FF F4 lwz *sr29, var_C(%sp) 
seg000:00118738 4E 80 00 20 blr 

seg000:00118738 # End of function check2 


We are lucky again: some function names are left in the executable (debug symbols 
section? 

Hard to say while we are not very familiar with the file format, maybe it is some kind 
of PE exports? (6.5.2)), 

like .RBEFINDNEXT() and .RBEFINDFIRST(). 


Eventually these functions call other functions with names like . GetNextDeviceViaUSB(), 
.USBSendPKT(), so these are clearly dealing with an USB device. 


There is even a function named .GetNextEve3Device()—sounds familiar, there was 
a Sentinel Eve3 dongle for ADB port (present on Macs) in 1990s. 


Let's first take a look on how the r3 register is set before return, while ignoring 
everything else. 


We know that a "good" r3 value has to be non-zero, zero r3 leads the execution flow 
to the message box with an error message. 


There are two li %r3, 1 instructions present in the function and one li %r3, 0 
(Load Immediate, i.e., loading a value into a register). The first instruction is at 
0x001186B0—and frankly speaking, it's hard to say what it means. 


What we see next is, however, easier to understand: . RBEFINDFIRST() is called: if 
it fails, O is written into r3 and we jump to exit, otherwise another function is called 
(check3())—if it fails too, . RBEFINDNEXT() is called, probably in order to look for 
another USB device. 


N.B.: clrlwi. %r@, %r3, 16 it is analogical to what we already saw, but it clears 
16 bits, i.e., 
.RBEFINDFIRST() probably returns a 16-bit value. 


B (stands for branch) unconditional jump. 
BEQ is the inverse instruction of BNE. 
Let's see check3(): 


seg000:0011873C check3: # CODE XREF: check2+88p 
seg000:0011873C 

seg000:0011873C .set var 18, -0x18 
seg000:0011873C .set var C, -0xC 
seg000:0011873C .set var 8, -8 

seg000:0011873C .set var 4, -4 

seg000:0011873C .set arg 8, 8 

seg000:0011873C 

seg000:0011873C 93 E1 FF FC stw *sr31, var_4(%sp) 
seg000:00118740 7C 08 02 A6 mflr *srO 
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100118744 
100118748 
:0011874C 
:00118750 
:00118750 
:00118754 
:00118758 
:0011875C 
:00118760 
:00118764 
:00118768 
:0011876C 
:00118770 
:00118774 
:00118778 
:0011877C 
:00118780 
100118784 
100118784 
100118784 
100118788 
:0011878C 
:00118790 
100118794 
100118798 
100118798 
100118798 
:0011879C 
:001187A0 
:001187A4 
:001187A8 
:001187AC 
:001187B0 
:001187B4 
:001187B8 
:001187BC 
:001187C0 
:001187C0 
:001187C0 
:001187C4 
:001187C8 
:001187CC 
:001187D0 
:001187D4 
:001187D4 
:001187D4 
:001187D8 
:001187DC 
:001187E0 
:001187E4 
:001187E8 
:001187EC 
:001187F0 


li %r5, 0 
stw %r30, var _8(%sp) 
lwz %r30, off 1485E8 + dword 24B704 
.uSing dword 24B704, %r30 
stw *sr29, var_C(%sp) 
addi %r29, *sr3, 0 
li *r3, 0 
stw %r0, arg 8(*ssp) 
stwu “sp, -0x50(%sp) 
lwz %r6, dword 24B704 
addi %r4, %sp, Ox50-«var 18 
bl . RBEREAD 
nop 
clrlwi. *srO, %r3, 16 
beq loc 118784 
li %r3, 0 
b exit 
loc 118784: # CODE XREF: check3+3Cj 
lhz *srO, Ox50+var_18(%sp) 
cmplwi %r@, 0x1100 
beq loc 118798 
li %r3, 0 
b exit 
loc 118798: # CODE XREF: check3+50j 
lwz %r6, dword 24B704 
addi %r4, %sp, Ox50-«var 18 
li %r3, 1 
li %r5, 0 
bl . RBEREAD 
nop 
clrlwi. %r0, %r3, 16 
beq loc 1187C0 
li %r3, 0 
b exit 
loc 1187C0: # CODE XREF: check3+78j 
lhz *srO, Ox50+var_18(%sp) 
cmplwi  *srO, Ox09AB 
beq loc 1187D4 
li %r3, 0 
b exit 


loc 1187D4: # CODE XREF: check3+8Cj 
bl sub B7BAC 
nop 


clrlwi %r0, %r3, 24 
cmpwi %r0, 5 

beq loc_1188E4 
bge loc 1187F8 
cmpwi ?srO, 4 

bge loc 118848 
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:001187F4 
:001187F8 
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:001187FC 
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:00118804 
:00118804 
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:00118884 
:00118884 
:00118888 
:0011888C 


b loc_118980 


loc 1187F8: # CODE XREF: check3+ACj 


cmpwi %rQ, OxB 
beq loc 118804 
b loc 118980 


loc 118804: # CODE XREF: check3+C0j 
lwz %r6, dword 24B704 


addi %r4, “sp, O0x50-var 18 
li %r3, 8 
li %r5, 0 
bl . RBEREAD 
nop 
clrlwi. %r0, %r3, 16 
beq loc 11882C 
li %r3, 0 
b exit 
loc 11882C: # CODE XREF: check3+E4j 
thz *srO0, 0x50+var_18(%sp) 
cmplwi %rQ, OXFEAO 
beq loc_118840 
li %r3, 0 
b exit 


loc_118840: # CODE XREF: check3+F8j 


li %r3, 1 
b exit 
loc_118848: # CODE XREF: check3+B4j 
lwz %r6, dword_24B704 
addi %r4, %sp, 0x50+var_18 
li %r3, OxA 
li %r5, 0 
bl . RBEREAD 
nop 
clrlwi. %r0, %r3, 16 
beq loc 118870 
li %r3, 0 
b exit 
loc_118870: # CODE XREF: check3+128j 
thz *srO, 0x50+var_18(%sp) 
cmplwi %r0, OxA6E1 
beq loc_118884 
li %r3, 0 
b exit 


loc_118884: # CODE XREF: check3+13Cj 
clrlwi %r31, %r29, 24 
cmplwi %r31, 2 
bne loc_118898 
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li %r3, 1 
b exit 


loc 118898: # CODE XREF: check3+150j 


lwz %r6, dword 24B704 
addi %r4, %sp, Ox50+var_18 
li *sr3, OxB 

li *sr5, 0 

bl . RBEREAD 

nop 

clrlwi. %r0, *r3, 16 

beq loc 1188C0 

li *r3, 0 

b exit 


loc 1188C0: # CODE XREF: check3+1783 


lhz %r0, Ox50+var_18(%sp) 
cmplwi %r@, 0x1C20 

beq loc 1188D4 

li %r3, 0 

b exit 


loc 1188D4: # CODE XREF: check3+18Cj 


cmplwi %r31, 3 


bne error 
li %r3, 1 
b exit 


loc_1188E4: # CODE XREF: check3+A8j 


lwz %r6, dword 24B704 
addi %r4, %sp, Ox50+var_18 
li %r3, OxC 

li %r5, 0 

bl . RBEREAD 

nop 

clrlwi. %r0, %r3, 16 

beq loc 11890C 

li *r3, 0 

b exit 


loc 11890C: # CODE XREF: check3+1C4j 


lhz *srO, Ox50+var_18(%sp) 
cmplwi %rQ, 0x40FF 

beq loc 118920 

li %r3, 0 

b exit 


loc 118920: # CODE XREF: check3+1D8j 


clrlwi %r31, %r29, 24 
cmplwi %r31, 2 


bne loc 118934 
li %r3, 1 
b exit 
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loc 118934: # CODE XREF: check3+1EC3 


lwz %r6, dword 24B704 
addi %r4, “sp, Ox50-var 18 
li %r3, OxD 
li %r5, 0 
bl . RBEREAD 
nop 
clrlwi. %r0, %r3, 16 
beq loc 11895C 
li %r3, 0 
b exit 
loc 11895C: # CODE XREF: check3+214j 
lhz *srO, Ox50+var_18(%sp) 
cmplwi %rQ, OxFC7 
beq loc 118970 
li %r3, 0 
b exit 


loc 118970: # CODE XREF: check3+228j 


cmplwi %r31, 3 
bne error 
li %r3, 1 
b exit 


loc 118980: £ CODE XREF: check3+B8j 
€ check3+C4j 


lwz *sr6, dword 24B704 
addi %r4, %sp, Ox50-«var 18 
li %r31, 0 
li %r3, 4 
li %r5, 0 
bl . RBEREAD 
nop 
clrlwi. *srO, %r3, 16 
beq loc 1189AC 
li %r3, 0 
b exit 
loc 1189AC: # CODE XREF: check3+264j 
lhz %r0, Ox50+var_18(%sp) 
cmplwi %rQ, OxAEDO 
bne loc 1189C0 
li %r31, 1 
b loc 1189D0 


loc 1189C0: # CODE XREF: check3+2783 


cmplwi %r0, 0x2818 
beq loc 1189D0 
li %r3, 0 

b exit 
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:00118A14 
:00118A18 
:00118A1C 
:00118A20 
:00118A20 
:00118A20 
:00118A24 
:00118A28 
:00118A2C 
:00118A30 
:00118A34 
:00118A34 
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:00118A44 
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38 


60 


00 


01 


loc 1189D0: # CODE XREF: check3+280j 
# check3+288j 


clrlwi r0, %r29, 24 
cmplwi r0, 2 
bne loc 1189F8 
clrlwi. 9?srO, %r31, 24 
beq good2 
bl sub 11D64C 
nop 
b exit 

good2: # CODE XREF: check3+2A4j 
li %r3, 1 
b exit 


loc 1189F8: £ CODE XREF: check3+29Cj 
lwz %r6, dword 24B704 


addi %r4, “sp, 0x50-var 18 
li %r3, 5 
li %r5, 0 
bl . RBEREAD 
nop 
clrlwi. %r0, %r3, 16 
beq loc 118A20 
li %r3, 0 
b exit 
loc 118A20: £ CODE XREF: check3+2D8j 
thz *srO, 0x50+var_18(%sp) 
cmplwi %r0, 0xD300 
bne loc 118A34 
li %r31, 1 
b good1 


loc 118A34: # CODE XREF: check3+2ECj 


cmplwi %rQ, OxEBAI 
beq good1 
li %r3, 0 
b exit 
good1: # CODE XREF: check3+2F4j 


# check3+2FCj 


clrlwi r0, %r29, 24 
cmplwi r0, 3 
bne error 
clrlwi. %r0, %r31, 24 
beq good 
bl sub 11D64C 
nop 
b exit 
good: # CODE XREF: check3+318j 
li %r3, 1 
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seg000:00118A68 48 00 00 08 b exit 

seg000:00118A6C 

seg000:00118A6C error: # CODE XREF: check3+19Cj 
seg000:00118A6C # check3+238j 
seg000:00118A6C 38 60 00 00 li %r3, 0 

seg000:00118A70 

seg000:00118A70 exit: # CODE XREF: check3+44j 
seg000:00118A70 # check3+58j 
seg000:00118A70 80 01 00 58  lwz *sr0, Ox50+arg_8(%sp) 
seg000:00118A74 38 21 00 50 addi “sp, *ssp, 0x50 
seg000:00118A78 83 E1 FF FC lwz *sr31, var_4(%sp) 
seg000:00118A7C 7C 08 03 A6  mtlr %rQ 

seg000:00118A80 83 C1 FF F8 lwz *sr30, var_8(%sp) 
seg000:00118A84 83 A1 FF F4 lwz *sr29, var_C(%sp) 
seg000:00118A88 4E 80 00 20 blr 

seg000:00118A88 # End of function check3 


There are a lot of calls to .RBEREAD(). 


Perhaps, the function returns some values from the dongle, so they are compared 
here with some hard-coded variables using CMPLWI. 


We also see that the r3 register is also filled before each call to . RBEREAD() with one 
of these values: 0, 1, 8, OxA, OxB, OxC, OxD, 4, 5. Probably a memory address or 
something like that? 


Yes, indeed, by googling these function names it is easy to find the Sentinel Eve3 
dongle manual! 


Perhaps we don't even have to learn any other PowerPC instructions: all this function 
does is just call . RBEREAD(), compare its results with the constants and returns 1 if 
the comparisons are fine or O otherwise. 


OK, all we've got is that check1() has always to return 1 or any other non-zero value. 


But since we are not very confident in our knowledge of PowerPC instructions, we 
are going to be careful: we will patch the jumps in check2() at 0x001186FC and 
0x00118718. 


At 0x001186FC we'll write bytes 0x48 and O thus converting the BEQ instruction in 
an B (unconditional jump): we can spot its opcode in the code without even referring 
to [PowerPC(tm) Microprocessor Family: The Programming Environments for 32-Bit 
Microprocessors, (2000)]!6. 


At 0x00118718 we'll write 0x60 and 3 zero bytes, thus converting it to a NOP instruc- 
tion: Its opcode we could spot in the code too. 


And now it all works without a dongle connected. 


In summary, such small modifications can be done with IDA and minimal assembly 
language knowledge. 


l6Also available as http://yurichev.com/mirrors/PowerPC/6xx pem.pdf 
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8.8.2 Example #2: SCO OpenServer 


An ancient software for SCO OpenServer from 1997 developed by a company that 
disappeared a long time ago. 


There is a special dongle driver to be installed in the system, that contains the fol- 
lowing text strings: "Copyright 1989, Rainbow Technologies, Inc., Irvine, CA" and 
“Sentinel Integrated Driver Ver. 3.0 ”. 


After the installation of the driver in SCO OpenServer, these device files appear in 
the /dev filesystem: 


/dev/rbsl8 
/dev/rbsl9 
/dev/rbs110 


The program reports an error without dongle connected, but the error string cannot 
be found in the executables. 


Thanks to IDA, it is easy to load the COFF executable used in SCO OpenServer. 


Let's also try to find “rbsl” string and indeed, found it in this code fragment: 


.text:00022AB8 public SSQC 

.text:00022AB8 SSQC proc near ; CODE XREF: SSQ+7p 
.text:00022AB8 

.text:00022AB8 var 44 - byte ptr -44h 
.text:00022AB8 var 29 - byte ptr -29h 


.text:00022AB8 arg 0 dword ptr 8 
.text:00022AB8 

.text:00022AB8 push ebp 
.text:00022AB9 mov ebp, esp 
.text:00022ABB sub esp, 44h 
.text:00022ABE push edi 
.text:00022ABF mov edi, offset unk 4035D0 
. text: 00022AC4 push esi 

. text: 00022AC5 mov esi, [ebp«arg 0] 
.text:00022AC8 push ebx 
.text:00022AC9 push esi 
.text:00022ACA call strlen 
.text:00022ACF add esp, 4 
.text:00022AD2 cmp eax, 2 
.text:00022AD7 jnz loc 22BA4 

. text: 00022ADD inc esi 

. text: 00022ADE mov al, [esi-1] 

. text: 00022AE1 movsx eax, al 

. text: 00022AE4 cmp eax, '3' 

. text: 00022AE9 jz loc 22B84 
.text:00022AEF cmp eax, '4' 
.text:00022AF4 jz loc 22B94 
.text:00022AFA cmp eax, '5' 
.text:00022AFF jnz short loc 22B6B 
.text:00022B01 movsx ebx, byte ptr [esi] 
.text:00022B04 sub ebx, '0' 
.text:00022B07 mov eax, 7 
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emails. Thanks! 


.text:00022B0C add eax, ebx 
.text:00022BOE push eax 

. text : 00022BOF lea eax, [ebp+var 44] 

. text: 00022B12 push offset aDevSlD ; "/dev/sl%d" 
. text: 00022B17 push eax 

. text: 00022B18 call nl sprintf 
.text:00022B1D push 0 + apt 
.text:00022B1F push offset aDevRbsl8 ; char * 
.text:00022B24 call | access 
.text:00022B29 add esp, 14h 
.text:00022B2C cmp eax, OFFFFFFFFh 
.text:00022B31 jz short loc 22B48 
.text:00022B33 lea eax, [ebx+7] 

. text: 00022B36 push eax 

. text : 00022B37 lea eax, [ebp«var 44] 

. text: 00022B3A push offset aDevRbslD ; "/dev/rbsl%d" 
. text: 00022B3F push eax 

. text: 00022B40 call nl_sprintf 

. text: 00022B45 add esp, OCh 

. text : 00022B48 

.text:00022B48 loc 22B48: ; CODE XREF: SSQC+79j 

. text: 00022B48 mov edx, [edi] 
.text:00022B4A test edx, edx 

. text: 00022B4C jle short loc 22B57 

. text: 00022B4E push edx ; int 
.text:00022B4F call | close 

.text:00022B54 add esp, 4 

.text:00022B57 

.text:00022B57 loc 22B57: ; CODE XREF: SSQC+94j 
.text:00022B57 push 2 ; int 
.text:00022B59 lea eax, [ebp«var 44] 
.text:00022B5C push eax ; char * 
.text:00022B5D call _ open 

. text: 00022B62 add esp, 8 

. text: 00022B65 test eax, eax 

. text: 00022B67 mov [edi], eax 

. text: 00022B69 jge short loc 22B78 
.text:00022B6B 

.text:00022B6B loc 22B6B: ; CODE XREF: SSQC«47j 
.text:00022B6B mov eax, OFFFFFFFFh 
.text:00022B70 pop ebx 

.text:00022B71 pop esi 

.text:00022B72 pop edi 

.text:00022B73 mov esp, ebp 
.text:00022B75 pop ebp 

.text:00022B76 retn 

.text:00022B78 

.text:00022B78 loc 22B78: ; CODE XREF: SSQC+B1j 
.text:00022B78 pop ebx 

.text:00022B79 pop esi 

.text:00022B7A pop edi 

.text:00022B7B xor eax, eax 
.text:00022B7D mov esp, ebp 
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.text:00022B7F pop ebp 

.text:00022B80 retn 

.text:00022B84 

.text:00022B84 loc 22B84: ; CODE XREF: SSQC-«31j 
.text:00022B84 mov al, [esi] 
.text:00022B86 pop ebx 

. text: 00022B87 pop esi 

. text: 00022B88 pop edi 

. text: 00022B89 mov ds: byte 407224, al 
. text: 00022B8E mov esp, ebp 

. text: 00022B90 xor eax, eax 

. text: 00022B92 pop ebp 

. text: 00022B93 retn 

. text: 00022B94 

.text:00022B94 loc 22B94: ; CODE XREF: SSQC+3Cj 
.text:00022B94 mov al, [esi] 
.text:00022B96 pop ebx 

.text:00022B97 pop esi 

.text:00022B98 pop edi 

.text:00022B99 mov ds:byte 407225, al 
.text:00022B9E mov esp, ebp 

. text: 00022BA0 xor eax, eax 

. text: 00022BA2 pop ebp 

. text: 00022BA3 retn 

. text: 00022BA4 

.text:00022BA4 loc 22BA4: ; CODE XREF: SSQC+1Fj 

. text: 00022BA4 movsx eax, ds:byte 407225 
. text: 00022BAB push esi 

. text: 00022BAC push eax 

. text : 00022BAD movsx eax, ds:byte 407224 
. text: 00022BB4 push eax 

. text: 00022BB5 lea eax, [ebp«var 44] 

. text: 00022BB8 push offset a46CCS ; "GO%c%C%S" 
. text: 00022BBD push eax 

. text: 00022BBE call nl sprintf 
.text:00022BC3 lea eax, [ebp+var 44] 

. text: 00022BC6 push eax 

. text: 00022BC7 call strlen 

. text: 00022BCC add esp, 18h 

. text: 00022BCF cmp eax, 1Bh 

. text: 00022BD4 jle short loc 22BDA 
.text:00022BD6 mov [ebp-var 29], 0 
.text:00022BDA 

.text:00022BDA loc 22BDA: ; CODE XREF: SSQC+11Cj 
.text:00022BDA lea eax, [ebp+var 44] 

. text: 00022BDD push eax 

. text: 00022BDE call strlen 

. text: 00022BE3 push eax ; unsigned int 
. text: 00022BE4 lea eax, [ebp+var 44] 

. text: 00022BE7 push eax ; void * 
. text: 00022BE8 mov eax, [edi] 

. text: 00022BEA push eax ; int 
.text:00022BEB call write 
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.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


00022BF0 
00022BF3 
00022BF4 
00022BF5 
00022BF6 
00022BF8 
00022BF9 
00022BFA 
00022BFA SSQC 


add 
pop 
pop 
pop 
mov 
pop 
retn 


esp, 10h 
ebx 
esi 
edi 
esp, ebp 
ebp 


db 0Eh dup(90h) 


endp 


Yes, indeed, the program needs to communicate with the driver somehow. 


The only place where the SSQC() function is called is the thunk function: 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
:0000DBF9 


.text 


.text: 
.text: 


0000DBE8 
0000DBE8 SSQ 
0000DBE8 
0000DBE8 
0000DBE8 arg 0 
0000DBE8 
0000DBE8 
0000DBE9 
0000DBEB 
0000DBEE 
0000DBEF 
0000DBF4 
0000DBF7 


0000DBFA 
0000DBFB SSQ 


public SSQ 
proc near ; CODE XREF: 
; Sys info+CBp ... 


sys info+A9p 


- dword ptr 8 
push ebp 

mov ebp, esp 
mov edx, [ebp+arg 0] 
push edx 

call SSQC 

add esp, 4 
mov esp, ebp 
pop ebp 

retn 

endp 


SSQ() can be called from at least 2 functions. 


One of these is: 


.data:0040169C 51 52 53 


DATA XREF: init sys-392r 
.data: 
.data: 

CO 
.data: 
.data: 
.data: 


NTINUE: 
004016A0 


0040169C 
0040169C 


004016A4 
004016A8 


.data:004016B8 3C or 3E 


sys info:loc D67Br 
.data: 
.data: 


004016B8 
004016BC 


dd offset aPressAnyKeyT 0 ; 


dd offset 
dd offset 
dd offset 


dd offset 


dd offset 


; these names we gave to the labels: 
.data:004016C0 answersl 
sys info+E7r 


.data: 


004016C4 


dd 6B05h 
dd 3D87h 


a51 
a52 
a53 


a3c 


a3e 


sys info+Alr 
"PRESS ANY KEY TO 


"51" 
"52" 
"53" 


DATA XREF: 


"3c" 
"JE" 


DATA XREF: 
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.data:004016C8 answers2 

sys info+F2r 
.data:004016CC 
.data:004016D0 C and B 

sys info+BAr 
.data:004016D0 
.data:004016D1 byte 4016D1 

DATA XREF: sys info+FDr 
.data:004016D2 


.text:0000D652 
.text:0000D654 
.text:0000D659 
.text:0000D660 
.text:0000D661 
.text:0000D666 
.text:0000D669 
.text:0000D66E 
.text:0000D670 
. text: 0000D672 
. text: 0000D677 
. text: 0000D679 
. text: 0000D67B 
. text: 0000D67B 
. text: 0000D67B 
. text: 0000D682 
. text: 0000D683 
. text: 0000D688 
. text: 0000D68D 
. text: 0000D692 
. text: 0000D697 
. text: 0000D69C 
.text:0000D69F 
.text:0000D6A6 
.text:0000D6A8 
.text:0000D6AA 
.text:0000D6B1 
.text:0000D6B3 
.text:0000D6B5 
.text:0000D6BB 
.text:0000D6BC 
. text: OOOODEBE 
. text: 0000D6CO0 
. text: 0000D6CO0 
. text: 0000D6CO0 
. text: 0000D6C6 
. text: 0000D6C8 
. text: 0000D6CD 
.text:0000D6CF 
.text:0000D6D1 
.text:0000D6D1 loc D6D1: ; 
.text:0000D6D1 ; 


loc D67B: ; 


loc D6C0: ; 


dd 3Ch ; DATA XREF: 
dd 832h 
db OCh ; DATA XREF: 
; Sys info:OKr 
db OBh : 
db 0 
xor eax, eax 
mov al, ds:ctl port 
mov ecx, 51 52 53[eax*4] 
push ecx 
call SSQ 
add esp, 4 
cmp eax, OFFFFFFFFh 
jz short loc D6D1 
xor ebx, ebx 
mov al, C and B 
test al, al 
jz short loc D6CO 
CODE XREF: sys info-106j 
mov eax, 3C or 3E[ebx*4] 
push eax 
call SSQ 
push offset a4g ; "4G" 
call SSQ 
push offset a0123456789 ; "0123456789" 
call SSQ 
add esp, OCh 
mov edx, answersl[ebx*4] 
cmp eax, edx 
jz short OK 
mov ecx, answers2[ebx*4] 
cmp eax, ecx 
jz short OK 
mov al, byte 4016D1[ebx] 
inc ebx 
test al, al 
jnz short loc D67B 
CODE XREF: sys info+C1j 
inc ds:ctl port 
xor eax, eax 
mov al, ds:ctl port 
cmp eax, edi 
jte short loc D652 
CODE XREF: sys info+98j 


sys info-B6j 
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.text:0000D6D1 mov edx, [ebp-var 8] 
.text:0000D6D4 inc edx 
.text:0000D6D5 mov [ebp-var 8], edx 
.text:0000D6D8 cmp edx, 3 
.text:0000D6DB jte loc D641 


.text:0000D6E1 
.text:0000D6E1 loc D6E1: ; CODE XREF: sys info+16j 


.text:0000D6E1 ; Sys info+51j 

.text:0000D6E1 pop ebx 
.text:0000D6E2 pop edi 
.text:0000D6E3 mov esp, ebp 
.text:0000D6E5 pop ebp 
.text:0000D6E6 retn 

.text:0000D6E8 OK: ; CODE XREF: sys info+F0j 
.text:0000D6E8 ; Sys info+FBj 

.text:0000D6E8 mov al, C and B[ebx] 
.text:0000D6EE pop ebx 

. text : 0000D6EF pop edi 
.text:0000D6F0 mov ds:ctl model, al 
.text:0000D6F5 mov esp, ebp 
.text:0000D6F7 pop ebp 
.text:0000D6F8 retn 

.text:0000D6F8 sys info endp 


"3C" and "3E" sound familiar: there was a Sentinel Pro dongle by Rainbow with no 
memory, providing only one crypto-hashing secret function. 


You can read a short description of what hash function is here: 2.5 on page 575. 
But let's get back to the program. 
So the program can only check the presence or absence of a connected dongle. 


No other information can be written to such dongle, as it has no memory. The two- 
character codes are commands (we can see how the commands are handled in the 
SSQC() function) and all other strings are hashed inside the dongle, being trans- 
formed into a 16-bit number. The algorithm was secret, so it was not possible to 
write a driver replacement or to remake the dongle hardware that would emulate it 
perfectly. 


However, it is always possible to intercept all accesses to it and to find what con- 
stants the hash function results are compared to. 


But we need to say that it is possible to build a robust software copy protection 
scheme based on secret cryptographic hash-function: let it encrypt/decrypt the data 
files your software uses. 


But let's get back to the code. 


Codes 51/52/53 are used for LPT printer port selection. 3x/4x are used for "family" 
selection (that's how Sentinel Pro dongles are differentiated from each other: more 
than one dongle can be connected to a LPT port). 


The only non-2-character string passed to the hashing function is "0123456789". 


Then, the result is compared against the set of valid results. 
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If it is correct, OxC or OxB is to be written into the global variable ctl model. 


Another text string that gets passed is "PRESS ANY KEY TO CONTINUE: ", but the 
result is not checked. Hard to say why, probably by mistake "7. 


Let's see where the value 


One such place is: 


from the global variable ctl model is used. 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


0000D708 prep sys 

0000D708 

0000D708 var 14 

0000D708 var 10 

0000D708 var 8 

0000D708 var 2 

0000D708 

0000D708 

0000D709 

0000D70E 

0000D710 

0000D713 

0000D715 

0000D717 

0000D71C 

.text:0000D71E 

.text:0000D720 
"Te-cvulnvV\\\bOKG]T 

. text: 0000D727 

. text: 0000D72C 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 


0000D7E7 loc D7E7: 
0000D7E7 
0000D7E7 
0000D7E8 
0000D7EB 
0000D7ED 
0000D7EE 
0000D7F0 
0000D7F5 
0000D7FA 
0000D7FF 


proc near ; CODE XREF: init sys+46Ap 


dword ptr -14h 
byte ptr -10h 


dword ptr -8 

word ptr -2 
push ebp 
mov eax, ds:net env 
mov ebp, esp 
sub esp, 1Ch 
test eax, eax 
jnz short loc D734 
mov al, ds:ctl model 
test al, al 
jnz short loc D77E 
ov [ebp+var_8], offset aleCvulnvvOkgT ; 


" 


mov edx, 7 

jmp loc D7E7 
; CODE XREF: prep sys+24j 
; prep _sys+33j 

push edx 

mov edx, [ebp+var_ 8] 

push 20h 

push edx 

push 16h 

call err_warn 

push offset station sem 

call ClosSem 

call startup err 


If it is O, an encrypted error message is passed to a decryption routine and printed. 


The error string decryption routine seems a simple xoring: 


.text:0000A43C err warn 
prep _sys+E8p 
.text:0000A43C 
.text:0000A43C 
.text:0000A43C var 55 
.text:0000A43C var 54 


proc near ; CODE XREF: 


; prep sys2+2Fp ... 


byte ptr -55h 
byte ptr -54h 


17What a strange feeling: to find bugs in such ancient software. 
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.text:0000A43C arg 0 - dword ptr 8 

.text:0000A43C arg 4 = dword ptr 0Ch 

.text:0000A43C arg 8 = dword ptr 10h 

.text:0000A43C arg C = dword ptr 14h 

. text: 0000A43C 

. text: 0000A43C push ebp 

. text: 0000A43D mov ebp, esp 

. text: 0000A43F sub esp, 54h 

. text: 0000A442 push edi 

. text: 0000A443 mov ecx, [ebp«arg 8] 

.text:0000A446 xor edi, edi 

.text:0000A448 test ecx, ecx 

.text:0000A44A push esi 

.text:0000A44B jte short loc A466 

.text:0000A44D mov esi, [ebp«arg C] ; key 

.text:0000A450 mov edx, [ebp*arg 4] ; string 

.text:0000A453 

.text:0000A453 loc A453: ; CODE XREF: 
err warn+28j 

.text:0000A453 xor eax, eax 

.text:0000A455 mov al, [edx+edi] 

.text:0000A458 xor eax, esi 

.text:0000A45A add esi, 3 

.text:0000A45D inc edi 

.text:0000A45E cmp edi, ecx 

.text:0000A460 mov [ebp+edit+var 55], al 

.text:0000A464 jl short loc A453 

.text:0000A466 

.text:0000A466 loc A466: ; CODE XREF: 
err warn-Fj 

.text:0000A466 mov [ebp+edi+var 54], 0 

. text: 0000A46B mov eax, [ebp«arg 0] 

. text: 0000A46E cmp eax, 18h 

. text: 0000A473 jnz short loc A49C 

.text:0000A475 lea eax, [ebp-«var 54] 

. text: 0000A478 push eax 

. text: 0000A479 call status line 

.text:0000A47E add esp, 4 

.text:0000A481 

.text:0000A481 loc A481: ; CODE XREF: 
err warn+72j 

.text:0000A481 push 50h 

.text:0000A483 push 0 

.text:0000A485 lea eax, [ebp-«var 54] 

.text:0000A488 push eax 

.text:0000A489 call memset 

.text:0000A48E call pcv refresh 

.text:0000A493 add esp, OCh 

.text:0000A496 pop esi 

.text:0000A497 pop edi 

.text:0000A498 mov esp, ebp 

.text:0000A49A pop ebp 

.text:0000A49B retn 

.text:0000A49C 
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.text:0000A49C loc A49C: ; CODE XREF: 
err warn+37j 
.text:0000A49C push 0 
.text:0000A49E lea eax, [ebpt+var_ 54] 
. text: 0000A4A1 mov edx, [ebp«arg 0] 
.text:0000A4A4 push edx 
.text:0000A4A5 push eax 
.text:0000A4A6 call pcv lputs 
.text:0000A4AB add esp, OCh 
.text:0000A4AE jmp short loc A481 
.text:0000A4AE err warn endp 


That's why we were unable to find the error messages in the executable files, be- 
cause they are encrypted (which is is popular practice). 


Another call to the SSQ() hashing function passes the "offln" string to it and com- 
pares the result with OxFE81 and 0x12A9. 


If they don't match, it works with some timer() function (maybe waiting for a poorly 
connected dongle to be reconnected and check again?) and then decrypts another 
error message to dump. 


.text:0000DA55 loc DA55: ; CODE XREF: 
sync _sys+24Cj 

.text:0000DA55 push offset a0ffln ; "offln" 

.text:0000DA5A call SSQ 

.text:0000DA5F add esp, 4 

.text:0000DA62 mov dl, [ebx] 

.text:0000DA64 mov esi, eax 

.text:0000DA66 cmp dl, OBh 

.text:0000DA69 jnz short loc DA83 

.text:0000DA6B cmp esi, OFE81h 

.text:0000DA71 jz OK 

. text: 0000DA77 cmp esi, OFFFFF8EFh 

. text: 0000DA7D jz OK 

. text: 0000DA83 

. text: 0000DA83 loc DA83: ; CODE XREF: 
sync sys+201j — 

.text:0000DA83 mov cl, [ebx] 

.text:0000DA85 cmp cl, OCh 

.text:0000DA88 jnz short loc DA9F 

.text:0000DA8A cmp esi, 12A9h 

.text:0000DA90 jz OK 

.text:0000DA96 cmp esi, OFFFFFFF5h 

.text:0000DA99 jz OK 

.text:0000DA9F 

.text:0000DA9F loc DA9F: ; CODE XREF: 
sync sys+220j — 

.text:0000DA9F mov eax, [ebp+var_ 18] 

.text:0000DAA2 test eax, eax 

. text : 0000DAA4 jz short loc DABO 

.text:0000DAA6 push 24h 

.text:0000DAA8 call timer 

.text:0000DAAD add esp, 4 


.text:0000DABO 
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.text:0000DABO loc DABO: ; CODE XREF: 
sync _sys+23Cj 

.text:0000DABO inc edi 

.text:0000DAB1 cmp edi, 3 

.text:0000DABA jte short loc DA55 

. text : 0000DAB6 mov eax, ds:net_env 

.text:0000DABB test eax, eax 

. text: 0000DABD jz short error 

.text:0000DAF7 error: ; CODE XREF: 
sync_sys+255j 

. text: 0000DAF7 ; Sync sys+274j 

.text:0000DAF7 mov [ebp-var 8], offset 2 
ú encrypted error message2 

.text:0000DAFE mov [ebp-var C], 17h ; decrypting key 

.text:0000DB05 jmp decrypt end print message 

; this name we gave to label: 

.text:0000D9B6 decrypt end print message: ; CODE XREF: 
sync _sys+29Dj 

.text:0000D9B6 ; Sync sys+2ABj 

.text:0000D9B6 mov eax, [ebp+var_18] 

. text: 0000D9B9 test eax, eax 

.text:0000D9BB jnz short loc D9FB 

.text:0000D9BD mov edx, [ebp+var_C] ; key 

.text:0000D9CO mov ecx, [ebp*var 8] ; string 

.text:0000D9C3 push edx 

. text: 0000D9C4 push 20h 

. text: 0000D9C6 push ecx 

. text: 0000D9C7 push 18h 

. text: 0000D9C9 call err_warn 

. text: 0000D9CE push OFh 

. text: 0000D9D0 push 190h 

.text:0000D9D5 call sound 

.text:0000D9DA mov [ebp-var 18], 1 

.text:0000D9E1 add esp, 18h 

. text: 0000D9E4 call pcv kbhit 

.text:0000D9E9 test eax, eax 

.text:0000D9EB jz short loc D9FB 


; this name we gave to label: 


.data:00401736 encrypted error message2 db 74h, 72h, 78h, 43h, 48h, 6, 5Ah,7 


y 49h, 4Ch, 2 dup(47h) 
.data:00401736 

V 33h, 36h, 76h 
.data:00401736 

4 1Ah 


db 51h, 4Fh, 47h, 61h, 20h, 22h, 3Ch, 24h, 7 


db 3Ah, 33h, 31h, 0Ch, 0, OBh, 1Fh, 7, 1Eh, 7 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1075 
Bypassing the dongle is pretty straightforward: just patch all jumps afterthe relevant 
CMP instructions. 


Another option is to write our own SCO OpenServer driver, containing a table of 
questions and answers, all of those which present in the program. 
Decrypting error messages 


By the way, we can also try to decrypt all error messages. The algorithm that is 
located in the err warn() function is very simple, indeed: 


Listing 8.5: Decryption function 


.text:0000A44D mov esi, [ebp«arg C] ; key 

.text:0000A450 mov edx, [ebptarg 4] ; string 

.text:0000A453 loc A453: 

.text:0000A453 xor eax, eax 

.text:0000A455 mov al, [edx+edi] ; load encrypted byte 

.text:0000A458 xor eax, esi ; decrypt it 

.text:0000A45A add esi, 3 ; change key for the 
next byte 

.text:0000A45D inc edi 

.text:0000A45E cmp edi, ecx 

.text:0000A460 mov [ebp+edit+var 55], al 

.text:0000A464 jl short loc A453 


As we can see, not just string is supplied to the decryption function, but also the key: 


.text:0000DAF7 error: ; CODE XREF: 

sync Sys4255j 
.text:0000DAF7 ; Sync Sys-*274j 
.text:0000DAF7 mov [ebp+var_8], offset 2 

ú encrypted error message2 
.text:0000DAFE mov [ebp-var C], 17h ; decrypting key 
.text:0000DB05 jmp decrypt end print message 


; this name we gave to label manually: 


.text:0000D9B6 decrypt end print message: ; CODE XREF: 
sync _sys+29Dj 

. text: 0000D9B6 ; Sync sys+2ABj 

.text:0000D9B6 mov eax, [ebp+var_18] 

. text: 0000D9B9 test eax, eax 

. text: 0000D9BB jnz short loc D9FB 

.text:0000D9BD mov edx, [ebp+var_ C] ; key 

.text:0000D9CO mov ecx, [ebp+var 8] ; string 

.text:0000D9C3 push edx 

. text: 0000D9C4 push 20h 

. text: 0000D9C6 push ecx 

. text: 0000D9C7 push 18h 

. text: 0000D9C9 call err_warn 
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The algorithm is a simple xoring: each byte is xored with a key, but the key is in- 
creased by 3 after the processing of each byte. 


We can write a simple Python script to check our hypothesis: 


Listing 8.6: Python 3.x 


#!/usr/bin/python 
import sys 


msg=[0x74, 0x72, 0x78, 0x43, 0x48, 0x6, 0x5A, 0x49, Ox4C, 0x47, 0x47, 
0x51, Ox4F, 0x47, 0x61, 0x20, 0x22, Ox3C, 0x24, 0x33, 0x36, 0x76, 
Ox3A, 0x33, 0x31, 0x0C, 0x0, Ox0B, 0x1F, 0x7, OXx1E, 0x1A] 


key=0x17 

tmp=key 

for i in msg: 
sys.stdout.write ("*sc" % (i^tmp)) 
tmp=tmp+3 

sys.stdout. flush() 


And it prints: “check security device connection”. So yes, this is the decrypted 
message. 


There are also other encrypted messages with their corresponding keys. But need- 
less to say, it is possible to decrypt them without their keys. First, we can see that 
the key is in fact a byte. It is because the core decryption instruction (XOR) works 
on byte level. The key is located in the ESI register, but only one byte part of EST is 
used. Hence, a key may be greater than 255, but its value is always to be rounded. 


As a consequence, we can just try brute-force, trying all possible keys in the 0..255 
range. We are also going to skip the messages that has unprintable characters. 


Listing 8.7: Python 3.x 


#!/usr/bin/python 
import sys, curses.ascii 


msgs-[ 

[0x74, 0x72, 0x78, 0x43, 0x48, 0x6, 0x5A, 0x49, Ox4C, 0x47, 0x47, 
0x51, Ox4F, 0x47, 0x61, 0x20, 0x22, 0x3C, 0x24, 0x33, 0x36, 0x76, 
0x3A, 0x33, 0x31, 0x0C, 0x0, OxOB, 0x1F, 0x7, 0x1E, 0x1A], 


[0x49, 0x65, 0x2D, 0x63, 0x76, 0x75, 0x6C, Ox6E, 0x76, 0x56, Ox5C, 
8, Ox4F, Ox4B, 0x47, 0x5D, 0x54, Ox5F, Ox1D, 0x26, Ox2C, 0x33, 
0x27, 0x28, Ox6F, 0x72, 0x75, 0x78, 0x7B, Ox7E, 0x41, 0x44], 


[0x45, 0x61, 0x31, 0x67, 0x72, 0x79, 0x68, 0x52, Ox4A, 0x52, 0x50, 
0x0C, Ox4B, 0x57, 0x43, 0x51, 0x58, Ox5B, 0x61, 0x37, 0x33, 0x2B, 
0x39, 0x39, 0x3C, 0x38, 0x79, Ox3A, 0x30, 0x17, 0x0B, 0x0C], 


[0x40, 0x64, 0x79, 0x75, Ox7F, Ox6F, 0x0, Ox4C, 0x40, 0x9, Ox4D, Ox5A, 
0x46, 0x5D, 0x57, 0x49, 0x57, Ox3B, 0x21, 0x23, 0x6A, 0x38, 0x23, 
0x36, 0x24, 0x2A, 0x7C, 0x3A, Ox1A, 0x6, OxOD, OxOE, Ox0A, 0x14, 
0x10], 
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[0x72, 0x7C, 0x72, 0x79, 0x76, 0x0, 

0x50, 0x43, Ox4A, 0x59, Ox5D, 0x5B, 0x41, Ox41, 0x1B, 0x5A, 

0x24, 0x32, Ox2bE, 0x29, 0x28, 0x70, 0x20, 0x22, 0x38, 0x28, 0x36, 
0x0D, OxOB, 0x48, Ox4B, Ox4E]] 


def is string printable(s): 
return all(list(map(lambda x: curses.ascii.isprint(x), s))) 


cnt=1 
for msg in msgs: 
print ("message #%d" % cnt) 
for key in range(0,256): 
result=[] 
tmp=key 
for i in msg: 
result.append (i^tmp) 


tmp=tmp+3 
if is string printable (result): 
print ("keyz", key, "value=", "",join(list(map(chr,2 
Y result)))) 
cnt=cnt+1 
And we get: 
Listing 8.8: Results 
message +1 


key= 20 value= *eb*h%|* *hudw|_af{n~f%ljmSbnwlpk 
key= 21 value= ajc]i"}cawtgv{“bgto}g"millcmvkgh 
key= 22 value= bkd\j#rbbvsfuz! cduh|d#bhomdluj ni 
key= 23 value= check security device connection 
key= 24 value= Lifbl!pd|tqhsx#ejwjbb! ‘nQofbshlo 
message #2 

key= 7 value= No security device found 

key= 8 value= An#rbbvsVuz!cduhld#ghtme? !#!'!#! 
message #3 

key= 7 value= Bk<waoqNUpu$* yreoaNwpmpus j , bkTjh 
key= 8 value= Mj?vfnr0jqvssgxqd' ^ vwlstlk/clHii 
key= 9 value= Lm»ugasLkvw&fgpgag^uvcrwml." mwhj 
key= 10 value= Ol!td'tMhwx'efwfbf!tubuvnm!anvok 
key= 11 value= No security device station found 
key= 12 value= In#rjbvsnuz! {duhdd#r{* whho#gPtme 
message #4 

key= 14 value= Number of authorized users exceeded 
key= 15 value= Ovlmdq!hg#* juknuhydk!vrbsp!Zy' dbefe 
message #5 

key= 17 value= check security device station 
key= 18 value= "ijbh!td' tmhwx'efwfbf ! tubuVnm! '! 


There is some garbage, but we can quickly find the English-language messages! 


By the way, since the algorithm is a simple xoring encryption, the very same function 
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can be used to encrypt messages. If needed, we can encrypt our own messages, and 
patch the program by inserting them. 


8.8.3 Example #3: MS-DOS 


Another very old software for MS-DOS from 1995 also developed by a company that 
disappeared a long time ago. 


In the pre-DOS extenders era, all the software for MS-DOS mostly relied on 16-bit 
8086 or 80286 CPUs, so the code was 16-bit en masse. 


The 16-bit code is mostly same as you already saw in this book, but all registers are 
16-bit and there are less instructions available. 


The MS-DOS environment has no system drivers, and any program can deal with 
the bare hardware via ports, so here you can see the OUT/IN instructions, which are 
present in mostly in drivers in our times (it is impossible to access ports directly in 
user mode on all modern OSes). 


Given that, the MS-DOS program which works with a dongle has to access the LPT 
printer port directly. 


So we can just search for such instructions. And yes, here they are: 


seg030:0034 out port proc far ; CODE XREF: sent pro-22p 
seg030:0034 ; sent pro+2Ap ... 
seg030:0034 

seg030:0034 arg 0 - byte ptr 6 

seg030:0034 

seg030:0034 55 push bp 

seg030:0035 8B EC mov bp, sp 

seg030:0037 8B 16 7E E7 mov dx, out port ; 0x378 
seg030:003B 8A 46 06 mov al, [bp*arg 0] 
seg030:003E EE out dx, al 

seg030:003F 5D pop bp 

seg030:0040 CB retf 

seg030:0040 out port endp 


(All label names in this example were given by me). 


out port() is referenced only in one function: 


seg030:0041 sent pro proc far ; CODE XREF: check dongle-34p 
seg030:0041 

seg030:0041 var 3 = byte ptr -3 

seg030:0041 var 2 - word ptr -2 

seg030:0041 arg 0 - dword ptr 6 

seg030:0041 

seg030:0041 C8 04 00 00 enter 4, 0 

seg030:0045 56 push si 

seg030:0046 57 push di 

seg030:0047 8B 16 82 E7 mov dx, in port 1 ; 0x37A 
seg030:004B EC in al, dx 

seg030:004C 8A D8 mov bl, al 

seg030:004E 80 E3 FE and bl, OFEh 
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seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 


:0051 
:0054 
:0056 
:0059 
:005C 
:005E 
:005F 
:0062 
:0063 
:0066 
:0067 
:006A 
:006B 
:006E 
:006F 
:0071 
:0073 
:0073 
:0073 
:0074 
:0074 
:0074 
:0078 
:007A 
:007D 
:007E 
:0081 
:0082 
:0085 
:0086 
:0089 
:008A 
:008D 
:008E 
:0091 
:0092 
:0095 
:0096 
:0099 
:009A 
:009D 
:009E 
:00A1 
:00A2 
:00A5 
:00A6 
:00A9 
:00AA 
:00AD 
:00AF 
:00AF 
:00AF 
:00B2 


BE 


F6 
01 


04 


04 


FD 


1F 


00 


FF 


00 


FF 


96 


00 


FF 


00 


00 


or 
mov 
mov 
and 
mov 
out 
push 
push 
call 
pop 
push 
push 
call 
pop 
xor 
jmp 


loc 359D3: ; 
inc 


loc 359D4: ; 


loc 35A0F: ; 
mov 


bl, 4 

al, bl 

[bp+var 3], al 
bl, 1Fh 

al, bl 

dx, al 

OFFh 

cs 

near ptr out port 


cs 
near ptr out port 
CX 

si, si 

short loc 359D4 


CODE XREF: sent pro+37j 
si 


CODE XREF: sent pro+30j 
si, 96h 
short loc 359D3 
0C3h 
CS 
near ptr out port 


cs 

near ptr out_port 
cx 

0D3h 

cs 

near ptr out_port 


cs 
near ptr out_port 
cx 

0C7h 

cs 

near ptr out_port 
cx 

0D3h 

cs 

near ptr out_port 
cx 

di, OFFFFh 

short loc 35A4F 


CODE XREF: sent pro+BDj 
si, 4 
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seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 


:00B2 
:00B2 
:00B4 
:00B8 
:00B9 
:00BB 
:00BD 
:00C0 
:00CO 
:00CO 
:00C5 
:00C7 
:00CA 
:00CC 
:00CC 
:00CC 
:00CF 
:00D0 
:00D3 
:00D4 
:00D7 
:00D7 
:00D7 
:00D8 
:00DB 
:00DC 
:00DF 
:00E0 
:00E3 
:00E4 
:00E7 
:00E9 
:00EC 
:00ED 
:00EF 
:00EF 
:00EF 
:00F2 
:00F5 
:00F8 
:00F9 
:00FC 
:00FE 
:0100 
:0103 
:0104 
:0107 
:0108 
:010C 
:010D 
:010F 
:0112 
:0114 


80 


01 


FE 


00 


00 


FF 


00 


FF 


00 


FF 


FE 


FE 


06 
06 
07 


FE 


00 


FF 


82 


5F 


E7 


08+ 


E7 


loc 35A12: ; 
shl 
mov 
in 
test 
jnz 
or 


loc 35A20: ; 
test 
jz 
push 
jmp 


loc 35A2C: ; 
push 
push 
call 
pop 
push 


loc 35A37: ; 
push 
call 
pop 
push 
push 
call 
pop 
mov 
shl 
mov 
dec 
jnz 


loc 35A4F: ; 
les 
inc 
mov 
cbw 
mov 
or 
jnz 
push 
push 
call 
pop 
mov 
in 
mov 
and 
mov 
out 


CODE XREF: sent_pro+ACj 
di, 1 
dx, in port 2 ; 0x379 
al, dx 
al, 80h 
short loc 35A20 
di, 1 


CODE XREF: sent pro+7Aj 
[bp-var 2], 8 
short loc 35A2C 
0D7h ; '+' 
short loc 35A37 


CODE XREF: sent pro+84j 
0C3h 
CS 
near ptr out port 
CX 
0C7h 


CODE XREF: sent pro+89j 
CS 
near ptr out port 


CS 

near ptr out port 
CX 

ax, [bp*var 2] 
ax, 1 

[bp-var 2], ax 

si 

short loc 35A12 


CODE XREF: sent pro+6Cj 
bx, [bp«arg 0] 
word ptr [bp+arg 0] 
al, es:[bx] 


[bp+var_2], ax 
ax, ax 

short loc 35A0F 
OFFh 

cs 

near ptr out_port 
CX 

dx, in port 1 ; 0x37A 
al, dx 

cl, al 

cl, 5Fh 

al, cl 

dx, al 
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seg030:0115 EC in al, dx 

seg030:0116 8A C8 mov cl, al 

seg030:0118 F6 C1 20 test cl, 20h 

seg030:011B 74 08 jz short loc 35A85 
seg030:011D 8A 5E FD mov bl, [bp+var_3] 
seg030:0120 80 E3 DF and bl, ODFh 
seg030:0123 EB 03 jmp short loc 35A88 
seg030:0125 

seg030:0125 loc 35A85: ; CODE XREF: sent pro+DAj 
seg030:0125 8A 5E FD mov bl, [bp+var_3] 
seg030:0128 

seg030:0128 loc 35A88: ; CODE XREF: sent pro-E2j 
seg030:0128 F6 C1 80 test cl, 80h 

seg030:012B 74 03 jz short loc 35A90 
seg030:012D 80 E3 7F and bl, 7Fh 

seg030:0130 

seg030:0130 loc 35A90: ; CODE XREF: sent pro-EAj 
seg030:0130 8B 16 82 E7 mov dx, in port 1 ; 0x37A 
seg030:0134 8A C3 mov al, bl 

seg030:0136 EE out dx, al 

seg030:0137 8B C7 mov ax, di 

seg030:0139 5F pop di 

seg030:013A 5E pop si 

seg030:013B C9 leave 

seg030:013C CB retf 

seg030:013C sent pro endp 


This is again a Sentinel Pro "hashing" dongle as in the previous example. It is notice- 
ably because text strings are passed here, too, and 16 bit values are returned and 
compared with others. 


So that is how Sentinel Pro is accessed via ports. 


The output port address is usually 0x378, i.e., the printer port, where the data to the 
old printers in pre-USB era was passed to. 


The port is uni-directional, because when it was developed, no one imagined that 
someone will need to transfer information from the printer 18. 


The only way to get information from the printer is a status register on port 0x379, 
which contains such bits as "paper out", "ack", "busy"—thus the printer may signal 
to the host computer if it is ready or not and if paper is present in it. 


So the dongle returns information from one of these bits, one bit at each iteration. 


in port 2 contains the address of the status word (0x379) and in port 1 con- 
tains the control register address (0x374). 


It seems that the dongle returns information via the “busy” flag at seg030:00B9: 
each bit is stored in the DI register, which is returned at the end of the function. 


What do all these bytes sent to output port mean? Hard to say. Perhaps, commands 
to the dongle. 


181f we consider Centronics only. The following IEEE 1284 standard allows the transfer of information 
from the printer. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1082 


But generally speaking, it is not necessary to know: it is easy to solve our task 
without that knowledge. 


Here is the dongle checking routine: 


00000000 struct 0 struc ; (sizeof-0x1B) 

00000000 field 0 db 25 dup(?) ; string(C) 

00000019 A dw ? 

0000001B struct 0 ends 

dseg:3CBC 61 63 72 75* Q struct 0 <'hello', 01122h> 

dseg:3CBC 6E 00 00 00+ ; DATA XREF: check dongle-2bEo 
. Skipped ... 

dseg:3E00 63 6F 66 66+ struct 0 <'coffee', 7EB7h> 

dseg:3E1B 64 6F 67 00+ struct 0 «'dog', OFFADh> 

dseg:3E36 63 61 74 00+ struct 0 «'cat', OFF5Fh» 

dseg:3E51 70 61 70 65+ struct 0 «'paper', OFFDFh> 

dseg:3E6C 63 6F 6B 65+ struct 0 «'coke', OF568h> 

dseg:3E87 63 6C 6F 63+ struct 0 «'clock', 55EAh> 

dseg:3EA2 64 69 72 00+ struct 0 «'dir', OFFAEh> 

dseg:3EBD 63 6F 70 79+ struct O0 «'copy', 0F557h» 

seg030:0145 check dongle proc far ; CODE XREF: sub 3771D+3EP 

seg030:0145 

seg030:0145 var 6 = dword ptr -6 

seg030:0145 var 2 - word ptr -2 

seg030:0145 

seg030:0145 C8 06 00 00 enter 6, 0 

seg030:0149 56 push si 

seg030:014A 66 6A 00 push large 0 ; newtime 

seg030:014D 6A 00 push 0 ; cmd 

seg030:014F 9A C1 18 00+ call  biostime 

seg030:0154 52 push dx 

seg030:0155 50 push ax 

seg030:0156 66 58 pop eax 

seg030:0158 83 C4 06 add sp, 6 

seg030:015B 66 89 46 FA mov [bp-var 6], eax 

seg030:015F 66 3B 06 D8+ cmp eax, expiration 

seg030:0164 7E 44 jte short loc 35B0A 

seg030:0166 6A 14 push 14h 

seg030:0168 90 nop 

seg030:0169 OE push CS 

seg030:016A E8 52 00 call near ptr get rand 

seg030:016D 59 pop CX 

seg030:016E 8B FO mov si, ax 

seg030:0170 6B CO 1B imul ax, 1Bh 

seg030:0173 05 BC 3C add ax, offset Q 

seg030:0176 1E push ds 

seg030:0177 50 push ax 

seg030:0178 OE push CS 

seg030:0179 E8 C5 FE call near ptr sent pro 
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seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 


:017C 
:017F 
:0182 
:0184 
:0187 
:018B 
:018F 
:0192 
:0197 
:0199 
:019C 
:01A0 
:01A3 
:01A5 
:01A8 
:01AA 
:01AA 
:01AA 
:01AA 
:01AC 
:01AC 
:01AC 
:01AD 
:01AE 
:01AE 


CO 


loc 35B0A: ; C 
; Cc 


xor 


loc 35B0C: 
pop 
leave 
retf 

check dongle e 


que 


sp, 4 
[bp+var_2], ax 
ax, si 

ax, 18 

eax, ax 

edx, [bp*var 6] 
edx, eax 


expiration, edx 


bx, 
bx, 
.Q. A[bx] 
ax, [bp+var_2] 
short loc 35B0A 
ax, 1 

short loc 35B0C 


ODE XREF: check dongle+1Fj 
heck dongle+5Ej 

ax, ax 

ODE XREF: check dongle+63j 
si 


ndp 


Since the routine can be called very frequently, e.g., before the execution of each 
important software feature, and accessing the dongle is generally slow (because of 
the slow printer port and also slow MCU in the dongle), they probably added a way to 
Skip some dongle checks, by checking the current time in the biostime() function. 


The get rand() function uses the standard C function: 


seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 
seg030 


:01BF 
:01BF 
:01BF 
:01BF 
:01BF 
:01C0 
:01C2 
:01C7 
:01CB 
:01D0 
:01D4 
:01DA 
:01DC 
:01DF 
:01E0 
:01E0 


get rand proc 


arg 0 wor 
push 
mov 
call 
movsx 
movsx 
imul 
mov 
cdq 
idiv 
pop 
retf 

get rand endp 


far ; CODE XREF: check _dongle+25p 


d ptr 6 

bp 

bp, sp 

rand 

eax, ax 

edx, [bp«arg 0] 
eax, edx 

ebx, 8000h 


ebx 
bp 


So the text string is selected randomly, passed into the dongle, and then the result 
of the hashing is compared with the correct value. 
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The text strings seem to be constructed randomly as well, during software develop- 
ment. 


And this is how the main dongle checking function is called: 


seg033:087B 9A 45 01 96+ call check dongle 

seg033:0880 0B CO or ax, ax 

seg033:0882 74 62 jz short OK 

seg033:0884 83 3E 60 42+ cmp word 620E0, 0 

seg033:0889 75 5B jnz short OK 

seg033:088B FF 06 60 42 inc word 620E0 

seg033:088F 1E push ds 

seg033:0890 68 22 44 push offset aTrupcRequiresA ; 
"This Software Requires a Software Lock\n" 

seg033:0893 1E push ds 

seg033:0894 68 60 E9 push offset byte 6C7EO0 ; dest 

seg033:0897 9A 79 65 00+ call _strcpy 

seg033:089C 83 C4 08 add sp, 8 

seg033:089F 1E push ds 

seg033:08A0 68 42 44 push offset aPleaseContactA ; "Please Contact 

seg033:08A3 1E push ds 

seg033:08A4 68 60 E9 push offset byte 6C7E0 ; dest 

seg033:08A7 9A CD 64 00+ call _strcat 


Bypassing the dongle is easy, just force the check dongle() function to always 
return 0. 


For example, by inserting this code at its beginning: 


mov ax,0 
retf 


The observant reader might recall that the strcpy() C function usually requires two 
pointers in its arguments, but we see that 4 values are passed: 


seg033:088F 1E push ds 

seg033:0890 68 22 44 push offset aTrupcRequiresA ; 
"This Software Requires a Software Lock\n" 

seg033:0893 1E push ds 

seg033:0894 68 60 E9 push offset byte 6C7E0 ; dest 

seg033:0897 9A 79 65 00+ call _strcpy 

seg033:089C 83 C4 08 add sp, 8 


This is related to MS-DOS’ memory model. You can read more about it here: 11.7 on 
page 1264. 


So as you may see, strcpy() and any other function that take pointer(s) in argu- 
ments work with 16-bit pairs. 


Let’s get back to our example. DS is currently set to the data segment located in the 
executable, that is where the text string is stored. 


In the sent_pro() function, each byte of the string is loaded at 
seg030:00EF: the LES instruction loads the ES:BX pair simultaneously from the passed 
argument. 
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The MOV at seg030:00F5 loads the byte from the memory at which the ES:BX pair 
points. 


8.9 Encrypted database case #1 


(This part has been first appeared in my blog at 26-Aug-2015. Some discussion: 
https://news.ycombinator.com/item?id-10128684.) 
8.9.1 Base64 and entropy 


l've got the XML file containing some encrypted data. Perhaps, it's related to some 
orders and/or customers information. 


<?xml version = "1.0" encoding = "UTF-8"?> 
«Orders» 
«Order» 
«OrderID»21«/OrderID» 
«Data»yjmxhXUbhB/5MV45chPsXZWAJwIh1S0aD9lFn3XuJMSxJ3/E* 7 
\ UE3hsnH</Data> 
</Order> 
«Order» 
<0rderID>2</0rderID> 
<Data>0KGe/wnypFBjsy+U0C2P9FC5nDZP3XDZLMPCRaiBw90j Ik6Tu5U 7 
4 =</Data> 
</Order> 
«Order» 
<OrderID>3</OrderID> 
<Data>mqkXfdzv0KvEArdzh+zD90ETVGBFvcTBLs2ph1b5bYddExzp</ 7 
V Data» 
</Order> 
«Order» 
<0rderID>4</0rderID> 
<Data>FCx6JhIDqnESyT3HAepyE1BJ3cJd7wCk+APCRUeuNt ZdpCvQ2MR/7 7 
kLXt fUHUA==</Data> 
</Order> 


c 


The file is available here. 


This is clearly base64-encoded data, because all strings consisting of Latin charac- 
ters, digits, plus (+) and slash (/) symbols. There can be 1 or 2 padding symbols (=), 
but they are never occurred in the middle of string. Keeping in mind these base64 
properties, it's very easy to recognize them. 


Let's decode them and calculate entropies (9.2 on page 1195) of these blocks in 
Wolfram Mathematica: 


In[]:= ListOfBase64Strings = 


Map[First[#[[3]]] €, Cases[Import["encrypted.xml"], XMLElement["Data", ,7 
G  ], Infinity]]; 


In[]:= BinaryStrings = 
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Map[ImportString[£, {"Base64", "String"}] €, ListOfBase64Strings]; 
In[]:= Entropies = Map[N[Entropy[2, #]] &, BinaryStrings]; 


In[]: 
Out[] 


Variance[Entropies] 
0.0238614 


Variance is low. This means the entropy values are not very different from each other. 
This is visible on graph: 


In[]:= ListPlot[Entropies] 
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Most values are between 5.0 and 5.4. This is a sign that the data is compressed 
and/or encrypted. 


To understand variance, let's calculate entropies of all lines in Conan Doyle's The 
Hound of the Baskervilles book: 


In[]:= BaskervillesLines = Import["http://ww.gutenberg.org/cache/epub 7 
y /2852/pg2852.txt", "List"]; 


In[]:= EntropiesT = Map[N[Entropy[2, #]] &, BaskervillesLines]; 
In[]:= Variance[EntropiesT] 

Out[]= 2.73883 

In[]:= ListPlot[EntropiesT] 
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Most values are gathered around value of 4, but there are also values which are 
smaller, and they are influenced final variance value. 


Perhaps, shortest strings has smaller entropy, let's take short string from the Conan 
Doyle's book: 


In[]:= Entropy[2, "Yes, sir."] // N 
Out[]= 2.9477 


Let's try even shorter: 


In[]:= Entropy[2, "Yes"] // N 
Out[]= 1.58496 


In[]: 
Out[] 


Entropy[2, "No"] // N 
1. 


8.9.2 Is data compressed? 


OK, so our data is compressed and/or encrypted. Is it compressed? Almost all data 
compressors put some header at the start, signature, or something like that. As we 
can see, there are no consistent data at the start of each block. It’s still possible 
that this is a handmade data compressor, but they are very rare. On the other hand, 
handmade cryptoalgorithms are much more popular, because it’s very easy to make 
it work. Even primitive keyless cryptosystems like memfrob()!? and ROT13 works 


I?http://linux.die.net/man/3/memf rob 
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fine without errors. It's a serious challenge to write data compressor from scratch 
using only fantasy and imagination in a way so it will have no evident bugs. Some 
programmers implements data compression functions by reading textbooks, but this 
is also rare. The most popular two ways are: 1) just take open-source library like 
zlib; 2) copy&paste something from somewhere. Open-source data compressions 
algorithms usually puts some kind of header, and so do algorithms from sites like 
http://www.codeproject.com/. 


8.9.3 Is data encrypted? 


Major data encryption algorithms process data in blocks. DES—8 bytes, AES—16 
bytes. If the input buffer is not divided evenly by block size, it's padded by zeroes 
(or something else), so encrypted data will be aligned by cryptoalgorithm's block 
size. This is not our case. 


Using Wolfram Mathematica, | analyzed block's lengths: 


In[]:= Counts[Map[StringLength[#] €, BinaryStrings]] 

Out[]= «|42 -> 1858, 38 -> 1235, 36 -> 699, 46 -> 1151, 40 -> 1784, 
44 -> 1558, 50 -> 366, 34 -> 291, 32 -> 74, 56 -» 15, 48 -> 716, 
30 -> 13, 52 -» 156, 54 -> 71, 60 -> 3, 58 -> 6, 28 -» 4|» 


1858 blocks has size of 42 bytes, 1235 blocks has size of 38 bytes, etc. 
| made a graph: 


ListPlot[Counts[Map[StringLength[#] €, BinaryStrings]]] 
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1000 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1089 
So, most blocks has size between ~36 and ~48. There is also another thing to notice: 
all block sizes are even. No single block with odd size. 


There are, however, stream ciphers which can operate on byte level or even on bit 
level. 


8.9.4 CryptoPP 


The program which can browse this encrypted database is written C# and the .NET 
code is heavily obfuscated. Nevertheless, there is DLL with x86 code, which, after 
brief examination, has parts of the CryptoPP popular open-source library! (I just 
spotted "CryptoPP" strings inside.) Now it's very easy to find all functions inside of 
DLL because CryptoPP library is open-source. 


CryptoPP library has a lot of crypto-functions, including AES (AKA Rijndael). Newer 
x86 CPUs has AES helper instructions like AESENC, AESDEC and AESKEYGENASSIST 2°. 
They are not performing encryption/decryption completely, but they do significant 
amount of job. And newer CryptoPP versions use them. For example, here: 1, 2. 
To my surprise, during decryption, AESENC gets executed, while AESDEC is not (I just 
checked with my tracer utility, but any debugger can be used). | checked, if my CPU 
really supports AES instructions. Some Intel i3 CPUs are not. And if not, CryptoPP 
library falling back to AES functions implemented in old way ?!. But my CPU supports 
them. Why AESDEC is still not executed? Why the program use AES encryption in 
order to decrypt database? 


OK, it's not a problem to find a function which encrypts block. It is called 

CryptoPP: :Rijndael::Enc::ProcessAndXorBlock: src, and it can call another function: 
Rijndael::Enc::AdvancedProcessBlocks() src, which, in turn, can call two other func- 
tions ( AESNI Enc Block and AESNI Enc 4 Blocks ) which has AESENC instructions. 


So, judging by CryptoPP internals, 

CryptoPP: :Rijndael::Enc::ProcessAndXorBlock() encrypts one 16-byte block. Let's set 
breakpoint on it and see, what happens during decryption. | use my simple tracer 
tool again. The software must decrypt first data block now. Oh, by the way, here is 
the first data block converted from base64 encoding to hexadecimal data, let's have 
it at hand: 


00000000: CA 39 B1 85 75 1B 84 1F F9 31 5E 39 72 13 EC 5D .9..u....1^9r7 


S oe] 

00000010: 95 80 27 02 21 D5 2D 1A OF D9 45 OF 75 EE 24 C4 ..'.!.-...E.u.$2 
Me iy 

00000020: B1 27 7F 84 FE 41 37 86 C9 CO aw asa 


These are also arguments of the function from CryptoPP source files: 


size t Rijndael::Enc::AdvancedProcessBlocks(const byte *inBlocks, const 2 
y byte *xorBlocks, byte *outBlocks, size t length, word32 flags); 


So it has 5 arguments. Possible flags are: 


20https://en.wikipedia.org/wiki/AES instruction set 
21https://github.com/mmoss/cryptopp/blob/2772f7b57182b31a41659b48d5f35a7b6cedd34d/src/ 
rijndael.cpp#L355 
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enum (BT InBlockIsCounter-1, BT DontIncrementInOutPointers-2, BT XorInput 
S =4, BT_ReverseDirection=8, BT AllowParallel-16) 7 
y FlagsForAdvancedProcessBlocks; 


OK, run tracer on ProcessAndXorBlock() function: 


. tracer.exe -l:filename.exe bpf-filename.exe!0x4339a0,args:5,dump args:07 
y x10 


Warning: no tracer.cfg file. 

PID-1984|New process software.exe 

no module registered with image base 0x77320000 

no module registered with image base 0x76e20000 

no module registered with image base 0x77320000 

no module registered with image base 0x77220000 

Warning: unknown (to us) INT3 breakpoint at ntdll.dll!^ 
y LdrVerifyImageMatchesChecksum+0x96c (0x776c103b) 

(0) software.exe!0x4339a0(0x38b920, 0x0, 0x38b978, 0x10, 0x0) (called from ^ 
V software.exe!.text+0x33c0d (0x13e4c0d)) 

Argument 1/5 

0038B920: 01 00 00 00 FF FF FF FF-79 C1 69 0B 67 C1 04 7D "........ y.i.g7 
M 2 

Argument 3/5 

0038B978: CD CD CD CD CD CD CD CD-CD CD CD CD CD CD CD CD 7 
Ae ba We ihe: Sw OE RC RU z 

(0) software.exe!0x4339a0() -» 0x0 

Argument 3/5 difference 

00000000: C7 39 4E 7B 33 1B D6 1F-B8 31 10 39 39 13 A5 5D ".9N2 
S (3....1.99..]" 

(0) software. exe! 0x4339a0(0x38a828, 0x38a838, 0x38bb40, 0x0, 0x8) (called 7 
S from software.exe!.text+0x3a407 (0x13eb407)) 

Argument 1/5 

00384828: 95 80 27 02 21 D5 2D 1A-0F D9 45 OF 75 EE 24 C4 "..'.!.-...E.u.$2 
Me ie 

Argument 2/5 

0038A838: B1 27 7F 84 FE 41 37 86-C9 CO 00 CD CD CD CD CD ".'...A77 


Argument 3/5 

0038BB40: CD CD CD CD CD CD CD CD-CD CD CD CD CD CD CD CD v 
o dass i 

(0) software.exe!0x4339a0() -> 0x0 

(0) software.exe!0x4339a0(0x38b920, 0x38a828, 0x38bb30, 0x10, 0x0) (called 2 
V from software.exe!.text+0x33c0d (0x13e4c0d)) 

Argument 1/5 

0038B920: CA 39 B1 85 75 1B 84 1F-F9 31 5E 39 72 13 EC 5D ".9..u....1^9r7 
S "Tub 

Argument 2/5 

0038A828: 95 80 27 02 21 D5 2D 1A-OF D9 45 OF 75 EE 24 C4 "..,'.,!.-...E.u.$7 
CENE. 

Argument 3/5 

0038BB30: CD CD CD CD CD CD CD CD-CD CD CD CD CD CD CD CD 7 
G Misia deni a i 

(0) software.exe!0x4339a0() -> 0x0 
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Argument 3/5 difference 

00000000: 45 00 20 00 4A 00 4F 00-48 00 4E 00 53 00 00 00 "E. .J.0.H.N.S7 
NN 

(0) software.exe!0x4339a0(0x38b920, 0x0, 0x38b978, 0x10, 0x0) (called from 2 
4 software.exe!.text+0x33c0d (0x13e4c0d)) 

Argument 1/5 


0038B920: 95 80 27 02 21 D5 2D 1A-0F D9 45 OF 75 EE 24 C4 "..'..-,..E.u.$7 
S "iL 

Argument 3/5 

0038B978: 95 80 27 02 21 D5 2D 1A-0F D9 45 OF 75 EE 24 C4 "..'.!.-...E.u.$2 
S LLI 


(0) software.exe!0x4339a0() -> 0x0 

Argument 3/5 difference 

00000000: B1 27 7F E4 9F 01 E3 81-CF C6 12 FB B9 7C F1 BC 7 
Rw A MEE" PEE 

PID-1984|Process software.exe exited. ExitCode-0 (0x0) 


Here we can see inputs to the ProcessAndXorBlock() function, and outputs from it. 


This is output from the function during first call: 


00000000: C7 39 4E 7B 33 1B D6 1F-B8 31 10 39 39 13 A5 5D ".9N2 
S (3....1.99..]" 


Then the ProcessAndXorBlock() is called with zero-length block, 
but with 8 flag (BT ReverseDirection). 


Second call: 


00000000: 45 00 20 00 4A 00 4F 00-48 00 4E 00 53 00 00 00 "E. .J.0.H.N.S7 
bg nee 


Wow, there is some string familiar to us! 
Third call: 


00000000: B1 27 7F E4 9F 01 E3 81-CF C6 12 FB B9 7C F1 BC 7 
SE MK |.." 


The first output is very similar to the first 16 bytes of the encrypted buffer. 
Output of the first call of ProcessAndXorBlock(): 


00000000: C7 39 4E 7B 33 1B D6 1F-B8 31 10 39 39 13 A5 5D ".9N2 
V (3....1.99..]" 


First 16 bytes of encrypted buffer: 


00000000: CA 39 B1 85 75 1B 84 1F F9 31 5E 39 72 13 EC 5D  .9..u....1^9r..] 


There are too much equal bytes! How come AES encryption result can be very similar 
to the encrypted buffer while this is not encryption but rather decryption?! 
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8.9.5 Cipher Feedback mode 


The answer is CFB??: in this mode, AES algorithm used not as encryption algorithm, 
but as a device which generates cryptographically secure random data. The actual 
encryption is happening using simple XOR operation. 


Here is encryption algorithm (images are taken from Wikipedia): 


Initialization Vector (IV) 


CAN 
block cipher block cipher block cipher 
um Trenton | | 19 —[ AME d 
Plaintext Plaintext Plaintext 
I~ I~ cc > 1 
CITTTITITITITI CTITTTITITITITI C[TITITTITTITITIT] 
Ciphertext Ciphertext Ciphertext 


Cipher Feedback (CFB) mode encryption 


And decryption: 


Initialization Vector (IV) 


LTITITITITIITTI] 


| 


block cipher block cipher block cipher 
tey —| encryption | | "er encryption | | e —| encryption 


$ Ciphertext i Ciphertext $ Ciphertext 
-< -[TITITIITITIT] «OTT TT) 
LITITIITIIIIIIT] LITTIITIIIITIIIT] CLITITIIIIIIITI 

Plaintext Plaintext Plaintext 


Cipher Feedback (CFB) mode decryption 


Now let's see: AES encryption operation generates 16 bytes (or 128 bits) of random 
data to be used while XOR-ing, who forces us to use all 16 bytes? If at the last itera- 
tion we've got 1 byte of data, let's xor 1 byte of data with 1 byte of generated random 
data? This leads to important property of CFB mode: data can be not padded, data 
of arbitrary size can be encrypted and decrypted. 


22Cipher Feedback 
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Oh, that's why all encrypted blocks are not padded. And that's why AESDEC instruc- 
tion is never called. 


Let's try to decrypt first block manually, using Python. CFB mode also use IV, as a 
seed for CSPRNG^.. In our case, IV is the block which is encrypted at first iteration: 


0038B920: 01 00 00 00 FF FF FF FF-79 C1 69 0B 67 C1 04 7D "........ y.i.gv 
ES y 


Oh, and we also have to recover encryption key. There is AESKEYGENASSIST is DLL, 
and it is called, and it is used in the 

Rijndael::Base::UncheckedSetKey() function: src. It's easy to find it in IDA and set 
breakpoint. Let's see: 


. tracer.exe -l:filename.exe bpf-filename.exe!0x435c30,args:3,dump args:07 
y x10 


Warning: no tracer.cfg file. 

PID-2068|New process software.exe 

no module registered with image base 0x77320000 

no module registered with image base 0x76e20000 

no module registered with image base 0x77320000 

no module registered with image base 0x77220000 

Warning: unknown (to us) INT3 breakpoint at ntdll.dll!^ 
y LdrVerifyImageMatchesChecksum+0x96c (0x776c103b) 

(0) software.exe!0x435c30(0x15e8000, 0x10, 0x14f808) (called from software. / 
Vy exe!.text+0x22fal (0x13d3fa1)) 

Argument 1/3 

015E8000: CD C5 7E AD 28 5F 6D El-CE 8F CC 29 B1 21 88 8E "..-.( m....)7 
P 

Argument 3/3 

0014F808: 38 82 58 01 C8 B9 46 00-01 D1 3C 01 00 F8 14 00 "8.X...F7 
Ny ego nus rs 7 

Argument 3/3 +0x0: software.exe!.rdata+0x5238 

Argument 3/3 +0x8: software.exe!.text+0x1c101 

(0) software.exe!0x435c30() -» 0x13c2801 

PID-2068|Process software.exe exited. ExitCode-0 (0x0) 


So this is the key: CD C5 7E AD 28 5F 6D E1-CE 8F CC 29 B1 21 88 8E. 


During manual decryption we've got this: 


00000000: OD 00 FF FE 46 00 52 00 41 00 4E 00 4B 00 49 00  ....F.R.A.N.K.I7 
Go. 

00000010: 45 00 20 00 4A 00 4F 00 48 00 4E 00 53 00 66 66 E. .J.O.H.N.S.2 
V ff 

00000020: 66 66 66 9E 61 40 D4 07 06 01 fff.ab.... 


Now this is something readable! And now we can see why there were so many equal 
bytes at the first decryption iteration: because plaintext has so many zero bytes! 


Let's decrypt the second block: 


23Cryptographically Secure Pseudorandom Number Generator 
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00000000: 17 98 DO 84 3A E9 72 4F DB 82 3F AD E9 3E 2A AB ....:.r07 


Salas 
00000010: 41 00 52 00 52 00 4F 00 4E 00 CD CC CC CC CC CC A.R.R.O.NY 


y 
00000020: 1B 40 D4 07 06 01 .Q.... 


Third, fourth and fifth: 


00000000: 5D 90 59 06 EF F4 96 B4 7C 33 A7 4A BE FF 66 AB ].Y..... 13.3..f2 
Go. 

00000010: 49 00 47 00 47 00 53 00 00 00 00 00 00 CO 65 40 1.G.G.S....... 2 
V ea 


00000020: D4 07 06 01 


00000000: D3 15 34 5D 21 18 7C 6E AA F8 2D FE 38 F9 D7 4E ..4]!.|n..-.8..7 


GN 
00000010: 41 00 20 00 44 00 4F 00 48 00 45 00 52 00 54 00 A. .D.O.H.E.R.T2 
Go. 
00000020: 59 00 48 El 7A 14 AE FF 68 40 D4 07 06 02 Y.H.z...hQ.... 
00000000: 1E 8B 90 0A 17 7B C5 52 31 6C 4E 2F DE 1B 27 19 ..... (.R1lNZ 


M werk x 
00000010: 41 00 52 00 43 00 55 00 53 00 00 00 00 00 00 60 A.R.C.U.S7 


G 
00000020: 66 40 D4 07 06 03 f@.... 


All blocks decrypted seems correct except of first 16 bytes part. 


8.9.6 Initializing Vector 


What can affect first 16 bytes? 
Let's back to CFB decryption algorithm again: 8.9.5 on page 1092. 


We can see that IV can affect to first block decryption operation, but not the second, 
because during the second iteration, ciphertext from the first iteration is used, and 
in case of decryption, it's the same, no matter what IV has! 


So probably, IV is different each time. Using my tracer, l'Il take a look at the first 
input during decryption of the second block of XML file: 


0038B920: 02 00 00 00 FE FF FF FF-79 C1 69 0B 67 C1 04 7D "........ y.i.g7 
S "us 

„third: 

0038B920: 03 00 00 00 FD FF FF FF-79 C1 69 0B 67 C1 04 7D "........ y.i.g7 
m "En 


It seems, first and fifth byte are changed each time. | finally concluded that the first 
32-bit integer is just OrderlD from the XML file, and the second 32-bit integer is also 
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OrderlD, but negated. All other 8 bytes are same for each operation. Now | have de- 
crypted the whole database: https://beginners.re/paywall/REAB- source/current-tree/ 
/examples/encrypted DBl/decrypted.full.txt. 


The Python script used for this is: https: //beginners.re/paywall/REAB- source/ 
current-tree//examples/encrypted DBl/decrypt blocks.py. 


Perhaps, the author wanted each block encrypted differently, so he/she used OrderlD 
as part of key. It would be also possible to make different AES key instead of IV. 


So now we know that IV only affects first block during decryption in CFB mode, this 
is feature of it. All other blocks can be decrypted without knowledge IV, but using 
the key. 


OK, so why CFB mode? Apparently, because the very first AES example on CryptoPP 

wiki uses CFB mode: http://www. cryptopp.com/wiki/Advanced Encryption Standard# 
Encrypting and Decrypting Using AES. Supposedly, developer choose it for sim- 
plicity: the example can encrypt/decrypt text strings with arbitrary lengths, without 
padding. 


It is very likely, program’s author(s) just copypasted the example from CryptoPP wiki 
page. Many programmers do so. 


The only difference that IV is chosen randomly in CryptoPP wiki example, while this 
indeterminism wasn't allowable to programmers of the software we are dissecting 
now, so they choose to initialize IV using Order ID. 


Now we can proceed to analyzing matter of each byte in the decrypted block. 


8.9.7 Structure of the buffer 
Let’s take first four decrypted blocks: 


00000000: OD 00 FF FE 46 00 52 00 41 00 4E 00 4B 00 49 00  ....F.R.A.N.K.I7 
TERAN 45 00 20 00 4A 00 4F 00 48 00 4E 00 53 00 66 66 E. .J.0.H.N.S.7 
"OE 66 66 66 9E 61 40 D4 07 06 01 fff.a@.... 
00000000: OB 00 FF FE 4C 00 4F 00 52 00 49 00 20 00 42 00  ....L.O.R.I. .B7 
S 41 00 52 00 52 00 4F 00 4E 00 CD CC CC CC CC CC A.R.R.0.N7 
00000020: 18 40 DA 07 06 01 "M 
00000000: OA 00 FF FE 47 00 41 00 52 00 59 00 20 00 42 00. ....G.A.R.Y. .B7 
TPE 49 00 47 00 47 00 53 00 00 00 00 00 00 CO 65 40 I.G.G.S....... £z 
800923: D4 07 06 01 
00000000: OF 00 FF FE 4D 00 45 00 4C 00 49 00 4E 00 44 00  ....M.E.L.I.N.D7 
TET 41 00 20 00 44 00 4F 00 48 00 45 00 52 00 54 00 A. .D.O.H.E.R.T2 
Go. 
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00000020: 59 00 48 El 7A 14 AE FF 68 40 D4 07 06 02 Y.H.z...hQ.... 


UTF-16 encoded text strings are clearly visible, these are names and surnames. The 
first byte (or 16-bit word) is seems string length, we can visually check it. FF FE is 
seems Unicode BOM. 


There are 12 more bytes after each string. 


Using this script (https://beginners.re/paywall/REAB- source/current-tree/ 
/examples/encrypted DBl/dump buffer rest.py)l've got random selection of the 
tails: 


dennis@...:$ python decrypt.py encrypted.xml | shuf | head -20 


00000000: 48 El 7A 14 AE 5F 62 40 DD 07 05 08 H.z.. bQ.... 
00000000: 00 00 00 00 00 40 5A 40 DC 07 08 18 |. | |  J ..... @Z@.... 
00000000: 00 00 00 00 00 80 56 40 D7 07 OB 04 | | ...... V@.... 
00000000: 00 00 00 00 00 60 61 40 D7 07 OC 1C | . ...... a@.... 
00000000: 00 00 00 00 00 20 63 40 D9 07 0518 | |  ..... cQ.... 
00000000: 3D 0A D7 A3 70 FD 34 40 D7 07 07 11 =...p.4@.... 
00000000: 00 00 00 00 00 AO 63 40 D5 07 05 19 | | ...... cQ.... 
00000000: CD CC CC CC CC 3C 5C 40 D7 07 08 11  — —  —  — ....... Qui 
00000000: 66 66 66 66 66 FE 62 40 D4 07 06 05 Fffff.bQ.... 
00000000: 1F 85 EB 51 B8 FE 40 40 D6 07 09 1E ...Q..00.... 
00000000: 00 00 00 00 00 40 5F 40 DC 070218 |. | | ..... @@.... 
00000000: 48 El 7A 14 AE 9F 67 40 D8 07 05 12 H.z...9Q.... 
00000000: CD CC CC CC CC 3C 5E 40 DC 07 0107 — ...... EATE 
00000000: 00 00 00 00 00 00 67 40 D4 07 OBOE . |. |  ....... g@.... 
00000000: 00 00 00 00 00 40 51 40 DC 07 04 OB | |  J ..... @Q@.... 
00000000: 00 00 00 00 00 40 56 40 D7 07 07 OBA a ae @v@.... 
00000000: 8F C2 F5 28 5C 7F 55 40 DB 07 01 16 o (9... 
00000000: 00 00 00 00 00 00 32 40 DB 07 06 09 | |  ...... 20.... 
00000000: 66 66 66 66 66 7E 66 40 D9 07 0A 06 fffff-fQ.... 
00000000: 48 El 7A 14 AE DF 68 40 D5 07 07 16 H.z...hQ.... 


We first see the 0x40 and 0x07 bytes present in each tail. The very last byte s 
always in 1..0x1F (1..31) range, I’ve checked. The penultimate byte is always in 
1..0xC (1..12) range. Wow, that looks like a date! Year can be represented as 16-bit 
value, and maybe last 4 bytes is date (16 bits for year, 8 bits for month and 8 more 
for day)? Ox7DD is 2013, 0x7D5 is 2005, etc. Seems fine. This is a date. There are 
8 more bytes. Judging by the fact this is database named orders, maybe some kind 
of sum is present here? | made attempt to interpret it as double-precision IEEE 754 
floating point and dump all values! 


Some are: 


71.0 
134.0 
51.95 
53.0 
121.99 
96.95 
98.95 
15.95 
85.95 
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Looks like real! 


Now we can dump names, sums and dates. 


plain: 

00000000: OD 00 FF FE 46 00 52 00 41 00 4E 00 4B 00 49 
Goa 

00000010: 45 00 20 00 4A 00 4F 00 48 00 4E 00 53 00 66 
S ff 

00000020: 66 66 66 9E 61 40 D4 07 06 01 

OrderID= 1 name= FRANKIE JOHNS sum= 140.95 date- 2004 / 

plain: 

00000000: OB 00 FF FE 4C 00 4F 00 52 00 49 00 20 00 42 
Goa 

00000010: 41 00 52 00 52 00 4F 00 4E 00 CD CC CC CC CC 
Nec REEL EU. 

00000020: 1B 40 D4 07 06 01 

OrderID= 2 name= LORI BARRON sum= 6.95 date- 2004 / 6 / 

plain: 

00000000: 0A 00 FF FE 47 00 41 00 52 00 59 00 20 00 42 
Goa 

00000010: 49 00 47 00 47 00 53 00 00 00 00 00 00 CO 65 
4 ea 

00000020: D4 07 06 01 

OrderID= 3 name= GARY BIGGS sum= 174.0 date= 2004 / 6 / 

plain: 

00000000: OF 00 FF FE 4D 00 45 00 4C 00 49 00 4E 00 44 
oa 

00000010: 41 00 20 00 44 00 4F 00 48 00 45 00 52 00 54 
Ga 

00000020: 59 00 48 El 7A 14 AE FF 68 40 D4 07 06 02 

OrderID= 4 name= MELINDA DOHERTY sum= 199,99 date= 2004 

plain: 

00000000: OB 00 FF FE 4C 00 45 00 4E 00 41 00 20 00 4D 
Goa 

00000010: 41 00 52 00 43 00 55 00 53 00 00 00 00 00 00 
Sa a e 

00000020: 66 40 D4 07 06 03 


00 


CC 


00 


40 


00 


60 


F.R 
E. .J.0 
fff.aq. 
1 
..L.0O. 
A.R.R.O 
.Q.. 
G.A. 
I.G.G.S 
..M.E 
A. .D.O 
Y.H.z 
/ 2 
.L.E 
A.R.C.U 
f@.. 


.A.N.K.I2 
.H.N.S.7 

R.I. .B2 
.NZ 

R.Y. .B2 
— » 
.L. I.N.D2 
.H.E.R. T2 
..hQ.... 
.N.A. .M2 
.S7 
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| OrderID= 5 name= LENA MARCUS sum= 179.0 date= 2004 / 6 / 3 | 


See more: https://beginners. re/paywall/RE4B- source/current-tree//examples/ 
encrypted DBl/decrypted.full.with data.txt. Orfiltered: https://beginners. 
re/paywall/RE4B-source/current-tree//examples/encrypted DB1/decrypted.short. 
txt. Seems correct. 


This is some kind of OOP serialization, i.e., packing differently typed values into 
binary buffer for storing and/or transmitting. 


8.9.8 Noise at the end 


The only question remaining is that sometimes, tail is bigger: 


00000000: OE 00 FF FE 54 00 48 00 45 00 52 00 45 00 53 00 ....T.H.E.R.E.S7 
90006010: 45 00 20 00 54 00 55 00 54 00 54 00 4C 00 45 00 E. .T.U.T.T.L.E7 
00006020: 66 66 66 66 66 1E 63 40 D4 07 07 1A 00 07 07 19 fffff.c@v 
ÜrderlD- 172 name= THERESE TUTTLE sum= 152.95 date= 2004 / 7 / 26 


(00 07 07 19 bytes are not used and is ballast.) 


00000000: OC 00 FF FE 4D 00 45 00 4C 00 41 00 4E 00 49 00  ....M.E.L.A.N.I7 
Go. 
00000010: 45 00 20 00 4B 00 49 00 52 00 4B 00 00 00 00 00 E. .K.I.R.K2 


S 
00000020: 00 20 64 40 D4 07 09 02 00 02 . d@...... 
OrderID- 286 name- MELANIE KIRK sum- 161.0 date- 2004/ 9/2 


(00 02 are not used.) 


After close examination, we can see, that the noise at the end of tail is just left from 
previous encryption! 


Here are two subsequent buffers: 


00000000: 10 00 FF FE 42 00 4F 00 4E 00 4E 00 49 00 45 00 ....B.O.N.N,T.E2 
Ga 

00000010: 20 00 47 00 4F 00 4C 00 44 00 53 00 54 00 45 00 .G.0.L.D.S.T.E7 
E 

00000020: 49 00 4E 00 9A 99 99 99 99 79 46 40 D4 07 07 19 I.N...... y FO? 
y 


OrderID- 171 name= BONNIE GOLDSTEIN sum= 44.95 date= 2004 / 7 / 25 


00000000: OE 00 FF FE 54 00 48 00 45 00 52 00 45 00 53 00  ....T.H.E.R.E.S7 
Go. 

00000010: 45 00 20 00 54 00 55 00 54 00 54 00 4C 00 45 00 E. .T.U.T.T.L.E? 
Ve 

00000020: 66 66 66 66 66 1E 63 40 D4 07 07 1A 00 07 07 19 fffff.c@v 
Ne ik a aes 


OrderID= 172 name= THERESE TUTTLE sum= 152.95 date= 2004 / 7 / 26 
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(The last 07 07 19 bytes are copied from the previous plaintext buffer.) 


Another two subsequent buffers: 


00000000: OD 00 FF FE 4C 00 4F 00 52 00 45 00 4E 00 45 00 ....L.O.R.E.N.E7 
00000010: 20 88 4F 00 54 00 AF 00 4F 00 4C 00 45 09 CD CC .0.T.0.0.L.E2 
00000020: CC CC CC 3C SE 40 D4 07 09 02 sm Qus. 
OrderID= 285 name= LORENE OTOOLE sum= 120.95 date= 2004 / 9 / 2 

00000000: OC 00 FF FE 4D 00 45 00 4C 00 41 00 4E 00 49 00 ....M.E.L.A.N. I7 
00000010: 45 08 20 00 4B 00 49 00 52 00 4B 00 00 00 00 00 E. .K.L.R.K7 
00000020: 00 20 64 40 DA 07 09 02 00 02 dQ...... 


OrderID- 286 name= MELANIE KIRK sum- 161.0 date- 2004/ 9 / 2 


The last 02 byte has been copied from the previous plaintext buffer. 


It’s possible if the buffer used while encrypting is global and/or isn't clearing before 
each encryption. The final buffer size is also chaotic, nevertheless, the bug left 
uncaught because it doesn't affect decrypting process, which just ignores noise at 
the end. This is common mistake. It's been present in OpenSSL (Heartbleed bug). 


8.9.9 Conclusion 


Summary: every practicing reverse engineer should be familiar with major crypto 
algorithms and also major cryptographical modes. Some books about it: 12.1.10 on 
page 1283. 


Encrypted database contents has been artificially constructed by me for the sake of 
demonstration. I’ve got most popular USA names and surnames from there: http:// 
stackoverflow.com/questions/1803628/raw-list-of-person-names, and com- 
bined them randomly. Dates and sums were also generated randomly. 


All files used in this part are here: https://beginners. re/paywall/RE4B- source/ 
current-tree//examples/encrypted DB1. 


Nevertheless, many features like these l've observed in real-world software applica- 
tions. This example is based on them. 


8.9.10 Post Scriptum: brute-forcing IV 


The case you have just seen has been artificially constructed, but is based on a real 
application I’ve reverse engineered. When I’ve been working on it, | first noticed that 
IV has been generating using some 32-bit number, and | wasn't able to find a link 
between this value and OrderlD. So | prepared to use brute-force, which is indeed 
possible here. 


It’s not a problem to enumerate all 32-bit values and try each as a base for IV. Then 
you decrypt the first 16-byte block and check for zero bytes, which are always at 
fixed places. 
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8.10 Overclocking Cointerra Bitcoin miner 


There was Cointerra Bitcoin miner, looking like that: 


o 
2 Y 


Abs. D * 


| TEX Linux 
pe- 


Figure 8.14: Board 


And there was also (possibly leaked) utility? which can set clock rate for the board. 
It runs on additional BeagleBone Linux ARM board (small board at bottom of the 
picture). 


And the author was once asked, is it possible to hack this utility to see, which fre- 
quency can be set and which are not. And it is possible to tweak it? 


The utility must be executed like that: ./cointool-overclock 0 0 900, where 900 
is frequency in MHz. If the frequency is too high, utility will print "Error with argu- 
ments" and exit. 


This is a fragment of code around reference to "Error with arguments" text string: 


24Can be downloaded here: https://beginners. re/paywall/RE4B- source/current-tree/ 
/examples/bitcoin_miner/files/cointool- overclock 
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emails. Thanks! 


. text: 0000ABC4 STR R3, [R11,£var 28] 
.text:0000ABC8 MOV R3, #optind 
.text:0000ABDO LDR R3, [R3] 

. text: 0000ABD4 ADD R3, R3, #1 
.text:0000ABD8 MOV R3, R3,LSL#2 
.text:0000ABDC LDR R2, [R11,#argv] 
.text:0000ABEO ADD R3, R2, R3 

. text: 0000ABE4 LDR R3, [R3] 

. text: 0000ABE8 MOV RO, R3 ; nptr 
.text:0000ABEC MOV R1, 40 ; endptr 
.text:0000ABFO MOV R2, #0 ; base 
.text:0000ABF4 BL strtoll 
.text:0000ABF8 MOV R2, RO 

.text:0000ABFC MOV R3, R1 

.text:0000AC00 MOV R3, R2 

. text: 0000AC04 STR R3, [R11,£var 2C] 

. text: 0000AC08 MOV R3, #optind 

. text: 0000AC10 LDR R3, [R3] 

. text: 0000AC14 ADD R3, R3, #2 

. text: 0000AC18 MOV R3, R3,LSL#2 

. text: 0000AC1C LDR R2, [R11,#argv] 

. text: 0000AC20 ADD R3, R2, R3 

. text: 0000AC24 LDR R3, [R3] 

. text: 0000AC28 MOV RO, R3 ; nptr 

. text: 0000AC2C MOV R1, #0 ; endptr 

. text: 0000AC30 MOV R2, #0 ; base 

. text: 0000AC34 BL strtoll 

. text: 0000AC38 MOV R2, RO 

.text:0000AC3C MOV R3, R1 

.text:0000AC40 MOV R3, R2 

.text:0000AC44 STR R3, [R11,#third argument] 
.text:0000AC48 LDR R3, [R11,£var 28] 

. text : 0000AC4C CMP R3, #0 

.text:0000AC50 BLT errors with arguments 
.text:0000AC54 LDR R3, [R11,£var 28] 
.text:0000AC58 CMP R3, #1 

.text:0000AC5C BGT errors with arguments 
.text:0000AC60 LDR R3, [R11,£var 2C] 
.text:0000AC64 CMP R3, #0 

.text:0000AC68 BLT errors with arguments 
.text:0000AC6C LDR R3, [R11,£var 2C] 
.text:0000AC70 CMP R3, #3 

.text:0000AC74 BGT errors with arguments 
.text:0000AC78 LDR R3, [Rl1,#third argument] 
.text:0000AC7C CMP R3, #0x31 
.text:0000AC80 BLE errors with arguments 
.text:0000AC84 LDR R2, [R11,#third argument] 
.text:0000AC88 MOV R3, 4950 
.text:0000AC8C CMP R2, R3 

.text:0000AC90 BGT errors with arguments 
.text:0000AC94 LDR R2, [R11,#third argument] 
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.text:0000AC98 MOV R3, #0X51EB851F 

. text: 0000ACAO SMULL R1, R3, R3, R2 

. text: 0000ACA4 MOV R1, R3,ASR#4 

. text: 0000ACA8 MOV R3, R2,ASR#31 

.text:0000ACAC RSB R3, R3, R1 

.text:0000ACBO MOV R1, #50 

.text:0000ACBA MUL R3, R1, R3 

.text:0000ACB8 RSB R3, R3, R2 

.text:0000ACBC CMP R3, #0 

.text:0000ACCO BEQ loc ACEC 

.text:0000ACCA 

.text:0000ACC4 errors with arguments 

.text:0000ACCA 

.text:0000ACCA LDR R3, [R11,#argv] 
.text:0000ACC8 LDR R3, [R3] 

.text:0000ACCC MOV RO, R3 ; path 

.text:0000ACDO BL . Xpg basename 

.text:0000ACDA MOV R3, RO 

.text:0000ACD8 MOV RO, #aSErrorwithArgu ; format 
.text:0000ACEO MOV R1, R3 

.text:0000ACEA BL printf 

.text:0000ACE8 B loc ADDA 

.text:0000ACEC ; ------------------------ eee re ee rr re re ee eee ee eee eee -ee 
.text:0000ACEC 

.text:0000ACEC loc ACEC ; CODE XREF: main+66C 
.text:0000ACEC LDR R2, [R11,#third argument] 
.text:0000ACFO MOV R3, #499 

.text:0000ACFA CMP R2, R3 

.text:0000ACF8 BGT loc AD08 

.text:0000ACFC MOV R3, 40x64 

.text:0000AD00 STR R3, [R11,£unk constant] 
.text:0000AD04 B jump to write power 
.text:0000AD08 ; ==... -- 
.text:0000AD08 

.text:0000AD08 loc AD08 ; CODE XREF: main+6A4 
.text:0000AD08 LDR R2, [R11,#third argument] 
.text:0000ADOC MOV R3, #799 

.text:0000AD10 CMP R2, R3 

.text:0000AD14 BGT loc AD24 

.text:0000AD18 MOV R3, 40x5F 

.text:0000AD1C STR R3, [R11,£unk constant] 
.text:0000AD20 B jump to write power 
.text:0000AD24 ; ------------------------------------------------------------ 
. text: 0000AD24 

.text:0000AD24 loc AD24 ; CODE XREF: main+6C0 
.text:0000AD24 LDR R2, [R11,£zthird argument] 
.text:0000AD28 MOV R3, #899 

.text:0000AD2C CMP R2, R3 

.text:0000AD30 BGT loc AD40 

.text:0000AD34 MOV R3, #0x5A 

.text:0000AD38 STR R3, [R11,£unk constant] 
.text:0000AD3C B jump to write power 
.text:0000AD40 ; ------------------------------------------------------------ 
If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


1103 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
:0000AD54 


.text 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
:0000AD78 


.text 


.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
.text: 
: 0000ADA4 


. text 


text: 
.text: 


.rodata:0000B378 aSErrorWithArgu DC 


XREF: main+684 


0000AD40 
0000AD40 
0000AD40 
0000AD44 
0000AD48 
0000AD4C 
0000AD50 


0000AD58 
0000AD5C 
0000AD5C 
0000AD5C 
0000AD5C 
0000AD60 
0000AD64 
0000AD68 
0000AD6C 
0000AD70 
0000AD74 
0000AD74 
0000AD74 
0000AD74 


0000AD7C 
0000AD80 
0000AD84 
0000AD88 
0000AD8C 
0000AD90 
0000AD94 
0000AD98 
0000AD9C 
0000ADAO0 


0000ADA8 
0000ADAC 


main+6B0 


loc_AD40 ; CODE XREF: main+6DC 
LDR R2, [R11,#third argument] 
MOV R3, #999 
CMP R2, R3 
BGT loc _AD5C 
MOV R3, #0x55 
STR R3, [R11,#unk_constant] 
B jump to write power 
loc AD5C ; CODE XREF: main+6F8 
LDR R2, [R11,#third argument] 
MOV R3, #1099 
CMP R2, R3 
BGT jump to write power 
MOV R3, 40x50 
STR R3, [R11,£unk constant] 
jump to write power ; CODE XREF: 
; main+6CC ... 
LDR R3, [R11,*var_28] 
UXTB R1, R3 
LDR R3, [R11,£var 2C] 
UXTB R2, R3 
LDR R3, [R11,£unk constant] 
UXTB R3, R3 
LDR RO, [R11,Zzthird argument] 
UXTH RO, RO 
STR RO, [SP,#0x44+var 44] 
LDR RO, [R11,£var 24] 
BL write power 
LDR RO, [R11,£var 24] 
MOV R1, #0x5A 
BL read loop 
B loc ADD4 


"*s: Error with arguments",0xA,0 ; DATA 


Function names were present in debugging information of the original binary, like 


write power, read loop. But labels inside functions were named by me. 


optind name looks familiar. It is from getopt *NIX library intended for command-line 
parsing—well, this is exactly what happens inside. Then, the 3rd argument (where 
frequency value is to be passed) is converted from a string to a number using a call 
to strtoll() function. 


The value is then checked against various constants. At OxACEC, it's checked, if it is 
lesser or equal to 499, and if it is so, 0x64 is to be passed to write power() function 
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(which sends a command through USB using send msg()). If it is greater than 499, 
jump to OxADOS is occurred. 


At OxADO8 it's checked, if it’s lesser or equal to 799. Ox5F is then passedtowrite power() 
function in case of success. 


There are more checks: for 899 at OxAD24, for 0x999 at OxAD40 and finally, for 1099 
at OxADSC. If the input frequency is lesser or equal to 1099, 0x50 will be passed (at 
OxAD6C) to write power() function. And there is some kind of bug. If the value 
is still greater than 1099, the value itself is passed into write power() function. 
Oh, it's not a bug, because we can't get here: value is checked first against 950 at 
OxAC88, and if it is greater, error message will be displayed and the utility will finish. 


Now the table between frequency in MHz and value passed to write power() func- 
tion: 


MHz hexadecimal | decimal 
499MHz 0x64 100 
799MHz Ox5f 95 
899MHz Ox5a 90 
999MHz 0x55 85 
1099MHz | 0x50 80 


As it seems, a value passed to the board is gradually decreasing during frequency 
increasing. 


Now we see that value of 950MHz is a hardcoded limit, at least in this utility. Can we 
trick it? 


Let's back to this piece of code: 


.text:0000AC84 LDR R2, [R11,#third argument] 

.text:0000AC88 MOV R3, $950 

.text:0000AC8C CMP R2, R3 

.text:0000AC90 BGT errors with arguments ; I've patched here to 00 
00 00 00 


We must disable BGT branch instruction at OXAC90 somehow. And this is ARM in ARM 
mode, because, as we see, all addresses are increasing by 4, i.e., each instruction 
has size of 4 bytes. NOP (no operation) instruction in ARM mode is just four zero 
bytes: 00 00 00 00. So by writing four zeros at OxAC90 address (or physical offset 
in file 0x2C90) we can disable the check. 


Now it's possible to set frequencies up to 1050MHz. Even more is possible, but due 
to the bug, if input value is greater than 1099, a value as is in MHz will be passed to 
the board, which is incorrect. 


| didn't go further, but if | had to, | would try to decrease a value which is passed to 
write power() function. 


Now the scary piece of code which I skipped at first: 
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.text:0000AC94 LDR R2, [R11,#third argument] 
.text:0000AC98 MOV R3, #0x51EB851F 

.text:0000ACAO SMULL R1, R3, R3, R2 ; R3=3rg_arg/3.125 
.text:0000ACA4 MOV R1, R3,ASR#4 ; R1=R3/16=3rg arg/50 
.text:0000ACA8 MOV R3, R2,ASR#31 ; R3-MSB(3rg arg) 
.text:0000ACAC RSB R3, R3, R1 ; R3=3rd_arg/50 
.text:0000ACBO MOV R1, 450 

.text:0000ACB4 MUL R3, R1, R3 ; R3=50*(3rd arg/50) 
.text:0000ACB8 RSB R3, R3, R2 

.text:0000ACBC CMP R3, 40 

.text:0000ACCO BEQ loc ACEC 


.text:0000ACCA 
.text:0000ACC4 errors with arguments 


Division via multiplication is used here, and constant is 0x51EB851F | wrote a simple 
programmer's calculator?? for myself. And I have there a feature to calculate modulo 
inverse. 


modinv32(0x51EB851F) 
Warning, result is not integer: 3.125000 
(unsigned) dec: 3 hex: 0x3 bin: 11 


That means that SMULL instruction at OxACAO is basically divides 3rd argument by 
3.125. In fact, all modinv32() function in my calculator does, is this: 


1 932 


c input 
Then there are additional shifts and now we see than 3rg argument is just divided 
by 50. And then it's multiplied by 50 again. Why? This is simplest check, if the input 
value is can be divided by 50 evenly. If the value of this expression is non-zero, x 
can't be divided by 50 evenly: 


x 


z- (L):50) 


This is in fact simple way to calculate remainder of division. 


And then, if the remainder is non-zero, error message is displayed. So this utility 
takes frequency values in form like 850, 900, 950, 1000, etc., but not 855 or 911. 


That’s it! If you do something like that, please be warned that you may damage your 
board, just as in case of overclocking other devices like CPUs, GPU*s, etc. If you 
have a Cointerra board, do this on your own risk! 


25https://yurichev.com/progcalc/ 
26Graphics Processing Unit 
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8.11 Breaking simple executable code encryptor 


We've got an executable file which is encrypted by relatively simple encryption. Here 
is it (only executable section is left here). 


First, all encryption function does is just adds number of position in buffer to the byte. 
Here is how this can be encoded: 


Listing 8.9: Python script 


#!/usr/bin/env python 
def e(i, k): 
return chr ((ord(i)+k) % 256) 


def encrypt (buf): 
return e(buf[0], 0)+ e(buf[1], 1)+ e(buf[2], 2) + e(buf[3], 3)+ e(buf 2 
Y [4], 4)+ e(buf[5], 5)+ e(buf[6], 6)+ e(buf[7], 7)+ 
e(buf[8], 8)+ e(buf[9], 9)+ e(buf[10], 10)+ e(buf[11], 11)+ e(7 
S buf[12], 12)+ e(buf[13], 13)+ e(buf[14], 14)+ e(buf[15], 15) 


Hence, if you encrypt buffer with 16 zeros, you'll get 0, 1, 2, 3... 12, 13, 14, 15. 
Propagating Cipher Block Chaining (PCBC) is also used, here is how it works: 


Plaintext Plaintext Plaintext 


OA — (GIIIIITIITITIIT]  — — —— LUIIIIIITITITI 


Initialization Vector (IV) 
A — p e 
block cipher block cipher block cipher 
umb AE MIL Seer 


OCON COI TTT Tit) CTITTTTTITTITITI 
Ciphertext Ciphertext Ciphertext 


Propagating Cipher Block Chaining (PCBC) mode encryption 


Figure 8.15: Propagating Cipher Block Chaining encryption (image is taken from 
Wikipedia article) 


The problem is to recover IV. Brute-force is also not an option, because IV is too long 
(16 bytes). Let's see, if it’s possible to recover IV for arbitrary encrypted executable 
file? 


Let'stry simple frequency analysis. This is 32-bit x86 executable code, so let's gather 
statistics about most frequent bytes and opcodes. I tried huge oracle.exe file from 
Oracle RDBMS version 11.2 for windows x86 and I’ve found that the most frequent 
byte (no surprise) is zero ( 1096). The next most frequent byte is (again, no surprise) 
OxFF ( 596). The next is Ox8B ( 596). 
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Ox8B is opcode for MOV, this is indeed one of the most busy x86 instructions. Now 
what about popularity of zero byte? If compiler needs to encode value bigger than 
127, it has to use 32-bit displacement instead of 8-bit one, but large values are very 
rare (2.1.8 on page 570), so it is padded by zeros. This is at least in LEA, MOV, PUSH, 
CALL. 


For example: 


8D BO 28 01 00 00 lea esi, [eax+128h] 
8D BF 40 38 00 00 lea edi, [edi+3840h] 


Displacements bigger than 127 are very popular, butthey are rarely exceeds 0x10000 
(indeed, such large memory buffers/structures are also rare). 


Same story with MOV, large constants are rare, the most heavily used are O, 1, 10, 
100, 2”, and so on. Compiler has to pad small constants by zeros to represent them 
as 32-bit values: 


BF 02 00 00 00 mov edi, 2 
BF 01 00 00 00 mov edi, 1 


Now about 00 and OxFF bytes combined: jumps (including conditional) and calls 
can pass execution flow forward or backwards, but very often, within the limits of 
the current executable module. If forward, displacement is not very big and also 
padded with zeros. If backwards, displacement is represented as negative value, so 
padded with OxFF bytes. For example, transfer execution flow forward: 


E8 43 OC 00 00 call _functionl 

E8 5C 00 00 00 call _function2 

OF 84 FO 0A 00 00 jz loc_4FO9A0 

OF 84 EB 00 00 00 jz loc_4EFBB8 
Backwards: 

E8 79 0C FE FF call  functionl 

E8 F4 16 FF FF call _function2 

OF 84 F8 FB FF FF jz loc 8212BC 

OF 84 06 FD FF FF jz loc FF1E7D 

OxFF byte is also very often occurred in negative displacements like these: 
8D 85 1E FF FF FF lea eax, [ebp-0E2h] 
8D 95 F8 5C FF FF lea edx, [ebp-0A308h] 


So far so good. Now we have to try various 16-byte keys, decrypt executable section 
and measure how often 0, OxFF and Ox8B bytes are occurred. Let's also keep in sight 
how PCBC decryption works: 
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Ciphertext Ciphertext Ciphertext 
CITTITITTIIITT CITITITITITIT] CITITITITITIT] 


block cipher block cipher block cipher 
Key decryption my decryption Key decryption 


Initialization Vector (IV) $ 


ON — e 
coco) LELITILIILILLD LILITILIIILID 
Plaintext Plaintext Plaintext 


Propagating Cipher Block Chaining (PCBC) mode decryption 


Figure 8.16: Propagating Cipher Block Chaining decryption (image is taken from 
Wikipedia article) 


The good news is that we don't really have to decrypt whole piece of data, but only 
slice by slice, this is exactly how | did in my previous example: 9.1.5 on page 1188. 


Now I'm trying all possible bytes (0..255) for each byte in key and just pick the byte 
producing maximal amount of 0/OxFF/Ox8B bytes in a decrypted slice: 


#!/usr/bin/env python 
import sys, hexdump, array, string, operator 


KEY LEN-16 


def chunks(l, n): 
# split n by l-byte chunks 
# https://stackoverflow.com/q/312443 
n = max(1, n) 
return [l[i:i + n] for i in range(0, len(1), n)] 


def read file(fname): 
file=open(fname, modez'rb') 
content-file.read() 
file.close() 
return content 


def decrypt byte (c, key): 
return chr((ord(c)-key) % 256) 


def XOR PCBC step (IV, buf, k): 
prev-IV 
rtz"" 
for c in buf: 
new c-decrypt byte(c, k) 
plainschr(ord(new c)^ord(prev)) 
prev=chr(ord(c)*ord(plain) ) 
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rt=rt+plain 
return rt 


each Nth byte-[""]*KEY LEN 


content-read file(sys.argv[1]) 
# split input by 16-byte chunks: 
all_chunks=chunks (content, KEY LEN) 
for c in all chunks: 
for i in range(KEY LEN): 
each Nth byte[i]zeach Nth byte[i] + c[i] 


# try each byte of key 
for N in range(KEY LEN): 
print "N=", N 
stat-() 
for i in range(256): 
tmp_key=chr(i) 
tmp-XOR PCBC step(tmp key,each Nth byte[N], N) 
# count 0, FFs and 8Bs in decrypted buffer: 
important_bytes=tmp.count('\x00')+tmp.count('\xFF')+tmp.count ('\x8B 
"A 
stat[i]-important bytes 
sorted stat = sorted(stat.iteritems(), key=operator.itemgetter(1), 2 
Ss reverse-True) 
print sorted stat[0] 


(Source code can be downloaded here.) 


| run it and here is a key for which 0/OxFF/Ox8B bytes presence in decrypted buffer 
is maximal: 


N- 0 
(147, 1224) 
N= 1 
(94, 1327) 
N- 2 
(252, 1223) 
N- 3 


ÉS 


1 


112, 1223) 


(143, 1177) 
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N- 11 

(108, 1286) 
N- 12 

(10, 1164) 
N- 13 

(3, 1271) 
N- 14 

(128, 1253) 
N- 15 

(232, 1330) 


Let's write decryption utility with the key we got: 


#!/usr/bin/env python 
import sys, hexdump, array 


def xor strings(s,t): 
# https://en.wikipedia.org/wiki/XOR cipherZExample implementation 
"""xor two strings together""" 
return "".join(chr(ord(a)^ord(b)) for a,b in zip(s,t)) 


IV=array.array('B', [147, 94, 252, 218, 38, 192, 199, 213, 225, 112, 143, 2 
S 108, 10, 3, 128, 232]).tostring() 


def chunks(l, n): 
n - max(1, n) 
return [l[i:i + n] for i in range(0, len(1), n)] 


def read file(fname): 
file=open(fname, mode='rb') 
content=file. read() 
file.close() 
return content 


def decrypt_byte(i, k): 
return chr ((ord(i)-k) % 256) 


def decrypt(buf): 
return "".join(decrypt byte(buf[i], i) for i in range(16) ) 


fout=open(sys.argv[2], mode='wb') 


prev=IV 
content-read file(sys.argv[1] ) 
tmp=chunks(content, 16) 
for c in tmp: 
new_c=decrypt(c) 
p=xor_ strings (new_c, prev) 
prev=xor_strings(c, p) 
fout.write(p) 
fout.close() 


(Source code can be downloaded here.) 
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Let's check resulting file: 


$ objdump -b binary -m i386 -D decrypted.bin 


5: 8b ff 

7: 55 

8: 8b ec 

a: 51 

b: 53 

C: 33 db 

e: 43 

f: 84 1d a0 
15: 75 09 
17: ff 75 08 
la: ff 15 bo 
20: 6a 6c 
22: ff 35 54 
28: ff 15 b4 
2e: 89 45 fc 
31: 85 cO 
33: Of 84 d9 
39: 56 
3a: 57 
3b: 6a 00 
3d: 50 
3e: ff 15 b8 
44: 8b 35 bc 
4a: 8b f8 
4C: al e0 e2 
51: 3b 05 e4 
57: 75 12 

59 53 

5a 6a 03 

5c 57 

5d ff d6 


e2 


13 
do 
13 


00 


13 
13 


05 
e2 


05 


00 
01 
00 


00 


00 
00 


01 
05 


01 


01 


01 


01 


00 


01 


01 


01 


%edi,%edi 

%ebp 

%esp,%ebp 

“e Ccx 

%ebx 

%ebx ,%ebx 

%ebx 

?sbl, 0x105e2a0 
0x20 

0x8 (*sebp) 
*0x10013b0 
$0x6c 
0x101d054 
*0x10013b4 
*seax , -Ox4(%ebp ) 
%eax , SAX 
0x112 

%esi 

%edi 

$0x0 

%eax 
*0x10013b8 
0x10013bc,%esi 
%eax , sedi 
0x105e2e0,%eax 
0x105e2e4,%eax 
0x6b 

%ebx 

$0x3 

%edi 

*%esi 


Yes, this is seems correctly disassembled piece of x86 code. The whole decrypted 
file can be downloaded here. 


In fact, this is text section from regedit.exe from Windows 7. But this example is 
based on a real case | encountered, so just executable is different (and key), algo- 


rithm is the same. 


8.11.1 Other ideas to consider 


What if | would fail with such simple frequency analysis? There are other ideas on 
how to measure correctness of decrypted/decompressed x86 code: 


* Many modern compilers aligns beginnings of functions at 16-byte border. So 
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the space left before is filled with NOPs (0x90) or other NOP instructions with 
known opcodes: .1.7 on page 1313. Or INT3 instructions (OxCC). 


Perhaps, the most frequent pattern in any assembly language is function call: 

PUSH chain / CALL / ADD ESP, X. This sequence can easily detected and 
found. l've even gathered statistics about average number of function argu- 
ments: 11.3 on page 1257. (Hence, this is average length of PUSH instructions 
chain.) 


Read more about incorrectly/correctly disassembled code: 5.11 on page 924. 


8.12 SAP 


8.12.1 About SAP client network traffic compression 


(This article first appeared in my blog, in 13-Jul-2010.) 


(Tracing the connection between the TDW NOCOMPRESS SAPGUI?” environment vari- 
able and the pesky annoying pop-up window and the actual data compression rou- 
tine.) 


It is known that the network traffic between SAPGUI and SAP is not encrypted by 
default, but compressed (see here”? and here??). 


It is also known that by setting the environment variable TDW NOCOMPRESS to 1, it 
is possible to turn the network packet compression off. 


But you will see an annoying pop-up window that cannot be closed: 


?7SAP GUI client 
28http://blog.yurichev.com/node/44 
29blog.yurichev.com 
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€ -4 Coeg ÓbBmIiles)aeuoeds mg o 
SAP 
New password 


Client ool Information 
Welcome to the IDES ECC 6.0 incl. EhP4 


User [4 
Password LEX EE] 
Sapgui 720 [/H/SAP 
Language 
E Environment information: 
O data compression switched off 


For maximum data security delete 
the setting[s] as soon as possible ! 


Figure 8.17: Screenshot 


Let's see if we can remove the window somehow. 
But before this, let's see what we already know. 


First: we know that the environment variable TDW_NOCOMPRESS is checked some- 
where inside the SAPGUI client. 


Second: a string like “data compression switched off” must be present somewhere 
in it. 

With the help of the FAR file manager??we can found that both of these strings are 
stored in the SAPguilib.dll file. 


So let's open SAPguilib.dll in IDA and search for the TDW NOCOMPRESS string. Yes, 
it is present and there is only one reference to it. 


We see the following fragment of code (all file offsets are valid for SAPGUI 720 win32, 
SAPguilib.dll file version 7200,1,0,9009): 


.text:6440D51B lea eax, [ebp+2108h+var_211C] 

. text: 6440D51E push eax ; int 

. text: 6440D51F push offset aTdw_nocompress ; 
"TDW NOCOMPRESS" 

.text:6440D524 mov byte ptr [edi+15h], 0 

. text: 64400528 call chk_env 

.text:6440D52D pop ecx 


30http://www.farmanager.com/ 
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.text:6440D52bE 
.text:6440D52F 
.text:6440D534 


; demangled name: 


. text: 6440D537 
. text: 6440D53D 
. text: 6440D53F 
. text: 64400541 


; demangled name: 


. text: 64400544 
. text: 6440D54A 
. text: 6440D54B 
. text: 64400551 
. text: 64400553 
. text: 64400556 


. text: 6440D557 


pop 
push 
lea 


ecx 
offset byte 64443AF8 
ecx, [ebp+2108h+var_211C] 


int ATL::CStringT::Compare(char const *)const 


call 
test 
jz 
lea 


ds:mfc90 1603 

eax, eax 

short loc 6440D55A 

ecx, [ebp+2108h+var_211C] 


const char* ATL::CSimpleStringT::operator PCXSTR 


call 
push 
call 
test 
setnz 
pop 
mov 


ds:mfc90 910 

eax Í 
ds:atoi 

eax, eax 

al 

ecx 

[edi+15h], al 


Str 


The string returned by chk env() via its second argument is then handled by the 
MFC string functions and then atoi ()?! is called. After that, the numerical value is 


stored in edi+15h. 


Also take a look at the chk env() function (we gave this name to it manually): 


.text:64413F20 ; int cdecl chk env(char *VarName, int) 
.text:64413F20 chk env proc near 

.text:64413F20 

.text:64413F20 DstSize = dword ptr -0Ch 
.text:64413F20 var 8 = dword ptr -8 
.text:64413F20 DstBuf = dword ptr -4 
.text:64413F20 VarName = dword ptr 8 
.text:64413F20 arg 4 = dword ptr 0OCh 
.text:64413F20 

.text:64413F20 push ebp 
.text:64413F21 mov ebp, esp 
.text:64413F23 sub esp, OCh 
.text:64413F26 mov [ebp+DstSize], 0 
. text: 64413F2D mov [ebp+DstBuf], 0 

. text :64413F34 push offset unk_6444C88C 
. text: 64413F39 mov ecx, [ebptarg 4] 


; (demangled name) ATL::CStringT::operator-(char const *) 


.text: 
.text: 


64413F3C 
64413F42 
.text:64413F45 
.text:64413F46 
.text:64413F49 
. text:64413F4A 
. text :64413F4D 
.text:64413F4E 
.text:64413F51 


call 
mov 
push 
mov 
push 
mov 
push 
lea 
push 


ds:mfc90 820 

eax, [ebp+VarName] 
eax ; 

ecx, [ebp+DstSize] 
ecx ; 

edx, [ebp+DstBuf] 

edx s 

eax, [ebp+DstSize] 
eax ; 


VarName 


DstSize 


DstBuf 


ReturnSize 


31standard C library function that converts the digits in a string to a number 
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.text:64413F52 call ds:getenv s 
.text:64413F58 add esp, 10h 

.text:64413F5B mov [ebp-var 8], eax 
.text:64413F5E cmp [ebp-var 8], 0 
.text:64413F62 jz short loc 64413F68 
.text:64413F64 xor eax, eax 

.text:64413F66 jmp short loc 64413FBC 
.text:64413F68 

.text:64413F68 loc 64413F68: 

.text:64413F68 cmp [ebp+DstSize], 0 

. text: 64413F6C jnz short loc 64413F72 
.text:64413F6E xor eax, eax 

.text:64413F70 jmp short loc 64413FBC 
.text:64413F72 

.text:64413F72 loc 64413F72: 

.text:64413F72 mov ecx, [ebp+DstSize] 
.text:64413F75 push ecx 

.text:64413F76 mov ecx, [ebptarg 4] 

; demangled name: ATL::CSimpleStringT<char, 1>::Preallocate(int) 
. text :64413F79 call ds:mfc90 2691 

. text: 64413F7F mov [ebp+DstBuf], eax 

. text: 64413F82 mov edx, [ebp+VarName] 

. text: 64413F85 push edx ; VarName 
. text: 64413F86 mov eax, [ebp+DstSize] 

. text :64413F89 push eax ; DstSize 
. text: 64413F8A mov ecx, [ebp+DstBuf] 

. text: 64413F8D push ecx ; DstBuf 
. text :64413F8E lea edx, [ebp+DstSize] 

. text: 64413F91 push edx ; ReturnSize 
.text:64413F92 call ds:getenv s 
.text:64413F98 add esp, 10h 

.text:64413F9B mov [ebp-var 8], eax 
.text:64413F9E push OFFFFFFFFh 

.text:64413FA0 mov ecx, [ebptarg 4] 

; demangled name: ATL::CSimpleStringT::ReleaseBuffer(int) 
.text:64413FA3 call ds:mfc90 5835 
.text:64413FA9 cmp [ebp-var 8], 0 
.text:64413FAD jz short loc 64413FB3 
.text:64413FAF xor eax, eax 

.text:64413FB1 jmp short loc_64413FBC 
.text:64413FB3 

.text:64413FB3 loc 64413FB3: 

.text:64413FB3 mov ecx, [ebptarg 4] 

; demangled name: const char* ATL::CSimpleStringT::operator PCXSTR 
.text:64413FB6 call ds:mfc90 910 
.text:64413FBC 

.text:64413FBC loc 64413FBC: 

.text:64413FBC 

.text:64413FBC mov esp, ebp 

.text:64413FBE pop ebp 
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.text:64413FBF 
.text:64413FBF chk env 


retn 
endp 


Yes. The getenv s()?? 
function is a Microsoft security-enhanced 


version of getenv()??. 


There are also some MFC string manipulations. 


Lots of other environment variables are checked as well. Here is a list of all variables 


that are being checked and what SAPGUI 
is turned on: 


would write to its trace log when logging 


DPTRACE 

TDW HEXDUMP 

TDW WORKDIR 

TDW SPLASHSRCEENOFF 


"GUI-OPTION: 
"GUI-OPTION: 
"GUI-OPTION: 
"GUI-OPTION: 


"GUI-OPTION: 
TDW REPLYTIMEOUT "GUI-OPTION: 
TDW PLAYBACKTIMEOUT "GUI-OPTION: 


TDW NOCOMPRESS 

TDW EXPERT 

TDW PLAYBACKPROGRESS 
TDW PLAYBACKNETTRAFFIC 


"GUI-OPTION: 
"GUI-OPTION: 
"GUI-OPTION: 
"GUI-OPTION: 


TDW PLAYLOG "GUI-OPTION: 
TDW PLAYTIME "GUI-OPTION: 
TDW LOGFILE "GUI-OPTION: 
TDW WAN "GUI-OPTION: 
TDW FULLMENU "GUI-OPTION: 
SAP CP / SAP CODEPAGE "GUI-OPTION: 


UPDOWNLOAD CP "GUI-OPTION: 


SNC PARTNERNAME "GUI-OPTION: 
SNC QOP "GUI-OPTION: 
SNC LIB "GUI-OPTION: 


"GUI-OPTION: 


SAPGUI INPLACE 


Trace set to %d” 

Hexdump enabled" 

working directory ‘%s”’ 

Splash Screen Off" 

Splash Screen On" 

reply timeout 96d milliseconds" 
PlaybackTimeout set to %d milliseconds” 
no compression read" 

expert mode" 

PlaybackProgress" 
PlaybackNetTraffic" 
/PlayLog is YES, file 96s" 

/PlayTime set to %d milliseconds” 
TDW_LOGFILE ‘%s”’ 

WAN - low speed connection enabled” 
FullMenu enabled” 

SAP CODEPAGE ‘%d’’ 
UPDOWNLOAD CP ‘%d’’ 

SNC name ‘%s”’ 

SNC QOP ‘%s”’ 

SNC is set to: %s” 
environment variable SAPGUI INPLACE is on" 


The settings for each variable are written in the array via a pointer in the EDI register. 


EDI is set before the function call: 


.text:6440EE00 lea 
here like 40x15... 

. text: 6440EE03 lea 
. text: 6440EE06 call 
. text: 6440EE0B mov 
. text: 6440EE0D xor 
. text: 6440EEOF cmp 
. text: 6440EE11 jz 

. text: 6440EE13 push 
. text: 6440EE14 push 


stopped after commandline interp".. 
. text: 6440EE19 push 
. text: 6440EE1F call 


edi, [ebp+2884h+var_ 2884] 


ecx, [esi+24h] 

load command line 

edi, eax 

ebx, ebx 

edi, ebx 

short loc 6440EE42 

edi 

offset aSapguiStoppedA ; 


; options 


"Sapgui 


dword 644F93E8 
FEWTraceError 


32MSDN 


33Standard C library returning environment variable 
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Now, can we find the data record mode switched on string? 
Yes, and the only reference is in 
CDwsGui::PrepareInfoWindow(). 


How do we get know the class/method names? There are a lot of special debugging 
calls that write to the log files, like: 


.text:64405160 push dword ptr [esi+2854h] 

.text:64405166 push offset aCdwsguiPrepare ; 
"\nCDwsGui: :PrepareInfoWindow: sapgui env"... 

. text: 6440516B push dword ptr [esi+2848h] 

.text:64405171 call dbg 

.text:64405176 add esp, OCh 

...OF 

.text:6440237A push eax 

.text:6440237B push offset aCclientStart 6 ; 
"CClient::Start: set shortcut user to '%"... 

.text:64402380 push dword ptr [edi+4] 

.text:64402383 call dbg 

.text:64402388 add esp, OCh 


It is very useful. 
So let's see the contents of this pesky annoying pop-up window's function: 


.text:64404F4F CDwsGui PrepareInfoWindow proc near 
. text: 64404F4F 
.text:64404F4F pvParam 
.text:64404F4F var 38 
.text:64404F4F var 34 
. text: 64404F4F rc 

. text: 64404F4F cy 
.text:64404F4F h 
.text:64404F4F var 14 
.text:64404F4F var 10 


byte ptr -3Ch 
dword ptr -38h 
dword ptr -34h 
tagRECT ptr -2Ch 
dword ptr -1Ch 
dword ptr -18h 
dword ptr -14h 
dword ptr -10h 


.text:64404F4F var 4 dword ptr -4 

.text:64404F4F 

. text: 64404F4F push 30h 

.text:64404F51 mov eax, offset loc 64438E00 

.text:64404F56 call . EH prolog3 

.text:64404F5B mov esi, ecx ; ECX is pointer to 
object 

.text:64404F5D xor ebx, ebx 

.text:64404F5F lea ecx, [ebp+var_14] 

.text:64404F62 mov [ebp-var 10], ebx 

; demangled name: ATL::CStringT(void) 

.text:64404F65 call ds:mfc90 316 

.text:64404F6B mov [ebp-var 4], ebx 

.text:64404F6E lea edi, [esi+2854h] 

.text:64404F74 push offset aEnvironmentInf ; 


"Environment information: \n" 
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.text:64404F79 mov 


ecx, edi 


; demangled name: ATL::CStringT::operator=(char const *) 


.text:64404F7B call 
.text:64404F81 cmp 
.text:64404F84 mov 
.text:64404F8A jbe 
.text:64404F8C push 
.text:64404F8F lea 
.text:64404F92 push 
"working directory: '%s'\n" 
.text:64404F97 push 


ds:mfc90 820 

[esi+38h], ebx 

ebx, ds:mfc90 2539 

short loc 64404FA9 
dword ptr [esi+34h] 

eax, [ebp+var_14] 

offset aWorkingDirecto ; 


eax 


; demangled name: ATL::CStringT::Format(char const *,...) 


.text:64404F98 call 
.text:64404F9A add 
.text:64404F9D lea 
.text:64404FA0 push 
.text:64404FA1 mov 


, 


demangled name: ATL::CStringT::operator+=(class ATL::CSimpleStringT«char, 


.text:64404FA3 call 
.text:64404FA9 

.text:64404FA9 loc 64404FA9: 
.text:64404FA9 mov 
.text:64404FAC test 
.text:64404FAE jbe 
.text:64404FBO push 
.text:64404FB1 lea 
. text: 64404FB4 push 


"trace level %d activated\n" 


ebx ; mfc90 2539 
esp, OCh 

eax, [ebp+var_ 14] 
eax 

ecx, edi 


ds:mfc90 941 


eax, [esi+38h] 

eax, eax 

short loc 64404FD3 

eax 

eax, [ebp+var_ 14] 

offset aTraceLevelDAct ; 


. text: 64404FB9 push eax 

; demangled name: ATL::CStringT::Format(char const *,...) 
. text: 64404FBA call ebx ; mfc90 2539 

. text : 64404FBC add esp, OCh 
.text:64404FBF lea eax, [ebp«var 14] 
.text:64404FC2 push eax 

.text:64404FC3 mov ecx, edi 


, 


demangled name: ATL: :CStringT::operator+=(class ATL: :CSimpleStringT<char, 


.text:64404FC5 call 
. text :64404FCB xor 
. text: 64404FCD inc 
. text: 64404FCE mov 
. text: 64404FD1 jmp 


. text: 64404FD3 

. text: 64404FD3 loc 64404FD3: 

. text: 64404FD3 xor 
. text: 64404FD5 inc 
. text: 64404FD6 

.text:64404FD6 loc 64404FD6: 


ds:mfc90 941 

ebx, ebx 

ebx 

[ebp-var 10], ebx 
short loc 64404FD6 


ebx, ebx 
ebx 


1> const &) 


1> const &) 
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.text:64404FD6 cmp 

.text:64404FD9 jbe 

.text:64404FDB cmp 

.text:64404FE2 jz 

. text: 64404FE4 push 
"hexdump in trace activated\n" 

.text:64404FE9 mov 


[esi-38h], ebx 

short loc 64404FF1 

dword ptr [esi+2978h], 0 
short loc 64404FF1 
offset aHexdumpInTrace ; 


ecx, edi 


; demangled name: ATL::CStringT::operator+=(char const *) 


.text:64404FEB call 
.text:64404FF1 

.text:64404FF1 loc 64404FF1: 
.text:64404FF1 


ds:mfc90 945 


byte ptr [esi+78h], 0 
short loc 64405007 
offset aLoggingActivat ; 


ecx, edi 


ds:mfc90 945 


.text:64404FF1 cmp 

.text:64404FF5 jz 

.text:64404FF7 push 

"logging activated\n" 

.text:64404FFC mov 

; demangled name: ATL::CStringT::operator+=(char const *) 
.text:64404FFE call 

.text:64405004 mov 


.text:64405007 
.text:64405007 loc 64405007: 


[ebp-var 10], ebx 


byte ptr [esi+3Dh], 0 
short bypass 
offset aDataCompressio ; 


ecx, edi 


ds:mfc90 945 


.text:64405007 cmp 

.text:6440500B jz 

.text:6440500D push 

"data compression switched off\n" 

.text:64405012 mov 

; demangled name: ATL::CStringT::operator+=(char const *) 
.text:64405014 call 

.text:6440501A mov 


.text:6440501D 
.text:6440501D bypass: 


[ebp-var 10], ebx 


eax, [esi+20h] 

eax, eax 

short loc 6440503A 
dword ptr [eax+28h], 0 
short loc 6440503A 
offset aDataRecordMode ; 


ecx, edi 


ds:mfc90 945 


.text:6440501D mov 
.text:64405020 test 
.text:64405022 jz 
.text:64405024 cmp 
.text:64405028 jz 
.text:6440502A push 
"data record mode switched on\n" 
.text:6440502F mov 
; demangled name: ATL::CStringT::operator+=(char const *) 
.text:64405031 call 
.text:64405037 mov 


.text:6440503A 
.text:6440503A loc 6440503A: 
.text:6440503A 


.text:6440503A mov 
.text:6440503C cmp 
.text:6440503F jnz 
.text:64405045 push 


[ebp-var 10], ebx 


ecx, edi 

[ebp-var 10], ebx 

loc 64405142 

offset aForMaximumData ; 
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"\nFor maximum data security delete\nthe s"... 


; demangled name: ATL::CStringT::operator+=(char const *) 


.text:6440504A call 
.text:64405050 xor 
.text:64405052 push 
.text:64405053 lea 
.text:64405056 push 
.text:64405057 push 
.text:64405058 push 
.text:6440505A call 
.text:64405060 mov 
.text:64405063 cmp 
.text:64405068 jte 
.text:6440506A cdq 
.text:6440506B sub 
.text:6440506D sar 
.text:6440506F mov 
. text: 64405072 

.text:64405072 loc 64405072: 
.text:64405072 push 
.text:64405073 mov 
.text:6440507A call 
.text:64405080 mov 
.text:64405083 mov 
.text:64405088 cmp 
.text:6440508A jz 
.text:64405090 push 
.text:64405092 call 


.text:64405098 mov 


.text:6440509E push 
.text:6440509F push 
.text:644050A2 call 
.text:644050A4 and 
.text:644050A8 and 
. text: 644050AC mov 
. text: 644050AF push 
. text: 644050B4 lea 
. text: 644050B7 push 
. text: 644050B8 lea 
. text: 644050BE mov 
. text: 644050C1 mov 


; demangled name: ATL::CSimpleStringT:: 


. text: 644050C8 call 
. text: 644050CE push 
. text: 644050CF lea 


ds:mfc90 945 


edi, edi 

edi ; fWinIni 
eax, [ebp+pvParam] 

eax ; pvParam 
edi ; uiParam 
30h ; uiAction 


ds:SystemParametersInfoA 
eax, [ebp+var_34] 

eax, 1600 

short loc 64405072 


eax, edx 
eax, 1 
[ebp-var 34], eax 


edi ; hWnd 
[ebp+cy], 0A0h 

ds :GetDC 

[ebp-var 10], eax 
ebx, 12Ch 

eax, edi 

loc 64405113 

11h EE 
ds:GetStockObject 
edi, ds:SelectObject 
eax Ph 
[ebp+var_10] ; hdc 
edi ; SelectObject 
[ebp+rc.left], 0 
[ebp+rc.top], 0 
[ebp+h], eax 


401h ; format 
eax, [ebp+rc] 
eax ; lprc 


ecx, [esi+2854h] 
[ebp+rc.right], ebx 
[ebp+rc. bottom], OB4h 


GetLength(void) 

ds:mfc90 3178 

eax ; cchText 
ecx, [esi+2854h] 


; demangled name: const char* ATL::CSimpleStringT::operator PCXSTR 


.text:644050D5 call 
.text:644050DB push 
.text:644050DC push 
.text:644050DF call 


ds:mfc90 910 

eax ; lpchText 
[ebp+var_10] ; hdc 
ds:DrawTextA 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1121 


.text:644050E5 
.text:644050E7 
.text:644050ED 
.text:644050F0 
.text:644050F3 
.text:644050F7 
.text:644050FB 
.text:644050FE 
.text:64405100 
.text:64405103 
.text:64405106 
.text:64405108 
.text:64405108 
.text:64405108 
.text:6440510B 
.text:6440510D 
.text:64405113 
.text:64405113 
.text:64405113 
.text:64405116 
.text:6440511B 
.text:6440511E 
.text:6440511F 
.text:64405120 
.text:64405121 
.text:64405124 
.text:64405129 
.text:6440512A 
.text:6440512C 
.text:6440512E 
.text:6440512F 
.text:64405131 
.text:64405137 
.text:6440513D 
.text:6440513F 
.text:64405140 
. text :64405142 
. text: 64405142 
. text: 64405142 


push 
call 
mov 
sub 
cmp 
lea 
mov 
jz 
push 
push 
call 


loc 64405108: 
push 
push 
call 


loc 64405113: 
mov 
push 
push 
inc 
push 
push 
mov 
add 
cdq 
sub 
sar 
push 
push 
push 
call 
xor 
inc 
jmp 


loc 64405142: 
push 


4 ; nIndex 
ds:GetSystemMetrics 
ecx, [ebptrc.bottom] 
ecx, [ebp+rc.top] 
[ebp+h1, 0 

eax, [eax+ecx+28h] 
[ebp+cy], eax 

short loc 6440510 
[ebp+h] Ph 
[ebp+var_10] ; hdc 
edi ; SelectObject 


[ebp+var_10] ; hDC 
0 ; hWnd 
ds :ReleaseDC 


eax, [ebp+var_ 38] 


80h ; uFlags 
[ebp+cy] ; cy 
eax 

ebx < CX 

eax Y 


eax, [ebp+var_34] 
eax, OFFFFFED4h 


eax, edx 

eax, 1 

eax PX 

0 ; hwndInsertAfter 


dword ptr [esi+285Ch] ; hWnd 
ds:SetWindowPos 

ebx, ebx 

ebx 

short loc 6440514D 


offset byte 64443AF8 


; demangled name: ATL::CStringT::operator=(char const *) 


.text:64405147 
.text:6440514D 
.text:6440514D 
.text:6440514D 
.text:64405153 
.text:64405155 
.text:6440515A 
.text:64405160 
.text:64405166 

"\nCDwsGui 
. text :6440516B 
. text: 64405171 
. text: 64405176 


call 


loc_6440514D: 


ds:mfc90 820 


dword 6450B970, ebx 
short loc 64405188 

sub 6441C910 

dword 644F858C, ebx 
dword ptr [esi+2854h] 
offset aCdwsguiPrepare ; 


::PrepareInfoWindow: sapgui env". 


push 
call 
add 


dword ptr [esi+2848h] 
dbg 
esp, OCh 
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.text:64405179 
.text:64405183 
.text:64405188 
.text:64405188 loc 64405188: 
.text:64405188 or 
.text:6440518C lea 


mov 
call 


dword 644F858C, 2 
sub 6441C920 


[ebp+var_4], OFFFFFFFFh 
ecx, [ebp+var_ 14] 


; demangled name: ATL::CStringT:: CStringT() 


. text: 6440518F call ds:mfc90 601 
.text:64405195 call . EH epilog3 
.text:6440519A retn 


.text:6440519A CDwsGui PrepareInfoWindow endp 


At the start of the function ECX has a pointer to the object (since it is a thiscall (3.21.1 
on page 683)-type of function). In our case, the object obviously has class type of 
CDwsGui. Depending on the option turned on in the object, a specific message part 
is to be concatenated with the resulting message. 


If the value at address this+0x3D is not zero, the compression is off: 


.text:64405007 loc 64405007: 


.text:64405007 cmp 

.text:6440500B jz 

. text: 6440500D push 
"data compression switched off\n" 

. text: 64405012 mov 


byte ptr [esi+3Dh], 0 
short bypass 
offset aDataCompressio ; 


ecx, edi 


; demangled name: ATL::CStringT::operator+=(char const *) 


call 
mov 


. text: 64405014 
. text: 6440501A 
. text: 6440501D 
.text:6440501D bypass: 


ds:mfc90 945 
[ebp-var 10], ebx 


It is interesting that finally the var 10 variable state defines whether the message 


is to be shown at all: 


.text:6440503C 
.text:6440503F 


cmp 
jnz 


[ebp-var 10], ebx 
exit ; bypass drawing 


; add strings "For maximum data security delete" / "the setting(s) as soon as 


possible !": 


.text:64405045 push 


offset aForMaximumData ; 


"\nFor maximum data security delete\nthe s"... 


.text:6440504A call 


ds:mfc90 945 ; 


ATL: :CStringT::operator+=(char const *) 


.text:64405050 xor 
.text:64405052 push 
.text:64405053 lea 
.text:64405056 push 
.text:64405057 push 
.text:64405058 push 
.text:6440505A call 


edi, edi 

edi ; fWinIni 
eax, [ebp+pvParam] 

eax ; pvParam 
edi ; uiParam 
30h ; uiAction 


ds:SystemParametersInfoA 
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.text:64405060 mov 
.text:64405063 cmp 
.text:64405068 jte 
.text:6440506A cdq 
.text:6440506B sub 
.text:6440506D sar 
.text:6440506F mov 


.text:64405072 
.text:64405072 loc 64405072: 


start drawing: 


.text:64405072 push 
.text:64405073 mov 
.text:6440507A call 


eax, [ebp+var 34] 
eax, 1600 
short loc 64405072 


eax, edx 
eax, 1 
[ebp+var_34], eax 


edi ; hWnd 
[ebp+cy], OAOh 
ds :GetDC 


Let’s check our theory on practice. 
JNZ at this line ... 


. text: 6440503F jnz 


exit ; bypass drawing 


.. replace it with just JMP, and we get SAPGUI working without the pesky annoying 


pop-up window appearing! 


Now let's dig deeper and find a connection between the 0x15 offset in the Load command line() 
(we gave it this name) function and the this+0x3D variable in CDwsGui::PreparelnfoWindow. 


Are we sure the value is the same? 


We are starting to search for all occurrences of the 0x15 value in code. For a small 
programs like SAPGUI, it sometimes works. Here is the first occurrence we've got: 


.text:64404C19 sub 64404C19 proc near 

.text:64404C19 

.text:64404C19 arg 0 - dword ptr 4 

.text:64404C19 

.text:64404C19 push ebx 

.text:64404C1A push ebp 

.text:64404C1B push esi 

.text:64404C1C push edi 

.text:64404C1D mov edi, [esp+10h+arg_ 0] 

.text:64404C21 mov eax, [edi] 

.text:64404C23 mov esi, ecx ; ESI/ECX are pointers to 
some unknown object. 

.text:64404C25 mov [esi], eax 

.text:64404C27 mov eax, [edi+4] 

. text: 64404C2A mov [esi+4], eax 

. text: 64404C2D mov eax, [edi+8] 

. text: 64404C30 mov [esi+8], eax 

. text: 64404C33 lea eax, [edi+0Ch] 

. text: 64404C36 push eax 

. text :64404C37 lea ecx, [esi+0Ch] 
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; demangled name:  ATL::CStringT::operator-(class ATL::CStringT ... &) 
.text:64404C3A call ds:mfc90 817 

.text:64404C40 mov eax, [edi+10h] 

.text:64404C43 mov [esi+10h], eax 

.text:64404C46 mov al, [edi+14h] 

.text:64404C49 mov [esi+14h], al 

.text:64404C4C mov al, [edi+15h] ; copy byte from 0x15 
text: 64404C4E mov [esi+15h], al ; to 0x15 offset in 


CDwsGui object 


The function has been called from the function named CDwsGui::CopyOptions! And 
thanks again for debugging information. 


But the real answer is in CDwsGui::Init(): 


.text:6440BOBF loc 6440BO0BF: 


.text:6440BOBF mov eax, [ebp«arg 0] 

. text: 6440B0C2 push [ebp+arg_ 4] 

. text: 6440B0C5 mov [esit+2844h], eax 

. text: 6440B0CB lea eax, [esi+28h] ; ESI is pointer to 
CDwsGui object 

. text: 6440B0CE push eax 

.text:6440BOCF call CDwsGui  CopyOptions 


Finally, we understand: the array filled in the Load command line() function is actu- 
ally placed in the CDwsGui class, but at address this+0x28. 0x15 + 0x28 is exactly 
Ox3D. OK, we found the point where the value is copied to. 


Let's also find the rest of the places where the 0x3D offset is used. Here is one of 
them in the CDwsGui::SapguiRun function (again, thanks to the debugging calls): 


.text:64409D58 cmp [esi+3Dh], bl ; ESI is pointer to 
CDwsGui object 

.text:64409D5B lea ecx, [esi+2B8h] 

.text:64409D61 setz al 

.text:64409D64 push eax ; arg 10 of 


CConnectionContext: :CreateNetwork 
push 


. text: 64409D65 dword ptr [esi+64h] 


; demangled name: const char* ATL::CSimpleStringT::operator PCXSTR 


.text:64409D68 call ds:mfc90 910 

.text:64409D68 ; no arguments 
.text:64409D6E push eax 

.text:64409D6F lea ecx, [esi+2BCh] 

; demangled name: const char* ATL::CSimpleStringT::operator PCXSTR 
.text:64409D75 call ds:mfc90 910 

.text:64409D75 ; no arguments 
.text:64409D7B push eax 

.text:64409D7C push esi 

.text:64409D7D lea ecx, [esi+8] 

.text:64409D80 call CConnectionContext  CreateNetwork 
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Let's check our findings. 

Replace the setz al here with the xor eax, eax / nop instructions, clear the TDW NOCOMPRESS 
environment variable and run SAPGUI. Wow! There pesky annoying window is no 

more (just as expected, because the variable is not set) but in Wireshark we can see 

that the network packets are not compressed anymore! Obviously, this is the point 

where the compression flag is to be set in the CConnectionContext object. 


So, the compression flag is passed in the 5th argument of CConnectionContext::CreateNetwork. 
Inside the function, another one is called: 


.text:64403476 push [ebp+compression] 

. text: 64403479 push [ebp«arg C] 
.text:6440347C push [ebp+arg_ 8] 
.text:6440347F push [ebp+arg_ 4] 
.text:64403482 push [ebp+arg_ 0] 
.text:64403485 call CNetwork  CNetwork 


The compression flag is passed here in the 5th argument to the CNetwork::CNetwork 
constructor. 


And here is how the CNetwork constructor sets the flag in the CNetwork object ac- 
cording to its 5th argument and another variable which probably could also affect 
network packets compression. 


.text:64411DF1 cmp [ebp+compression], esi 

.text:64411DF7 jz short set EAX to 0 

.text:64411DF9 mov al, [ebx+78h] ; another value may 
affect compression? 

. text :64411DFC cmp al, '3' 

.text:64411DFE jz short set_EAX to 1 

. text: 64411E00 cmp al, '4' 

. text: 64411E02 jnz short set_EAX_to 0 


. text: 64411E04 
.text:64411E04 set EAX to 1: 


.text:64411bE04 xor eax, eax 
.text:64411E06 inc eax ; EAX -> 1 
.text:64411E07 jmp short loc 64411E0B 


.text:64411E09 

.text:64411bE09 set EAX to 0: 

.text:64411bE09 

.text:64411E09 xor eax, eax ; EAX -> 0 

.text:64411E0B 

.text:64411bE0B loc 64411E0B: 

.text:64411E0B mov [ebx+3A4h], eax ; EBX is pointer to 
CNetwork object 


At this point we know the compression flag is stored in the CNetwork class at address 
this+0x3A4. 


Now let's dig through SAPguilib.dll for the 0x3A4 value. And here is the second 
occurrence in CDwsGui::OnClientMessageWrite (endless thanks for the debugging 
information): 
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.text:64406F76 loc 64406F76: 


.text:64406F76 mov ecx, [ebp+7728h+var_7794] 
.text:64406F79 cmp dword ptr [ecx+3A4h], 1 
.text:64406F80 jnz compression flag is zero 
.text:64406F86 mov byte ptr [ebx+7], 1 
.text:64406F8A mov eax, [esi+18h] 

. text: 64406F8D mov ecx, eax 

. text: 64406F8F test eax, eax 

. text: 64406F91 ja short loc 64406FFF 
.text:64406F93 mov ecx, [esi+14h] 
.text:64406F96 mov eax, [esi+20h] 


. text: 64406F99 
.text:64406F99 loc 64406F99: 


.text:64406F99 push dword ptr [edi+2868h] ; int 

.text:64406F9F lea edx, [ebp+7728h+var_77A4] 

. text :64406FA2 push edx ; int 

. text: 64406FA3 push 30000 ; int 

. text : 64406FA8 lea edx, [ebp+7728h+Dst] 

. text :64406FAB push edx ; Dst 

. text :64406FAC push ecx = int 

.text:64406FAD push eax ; Src 

.text:64406FAE push dword ptr [edi+28C0h] ; int 

.text:64406FB4 call sub_644055C5 ; actual 
compression routine 

.text:64406FB9 add esp, 1Ch 

.text:64406FBC cmp eax, OFFFFFFF6h 

.text:64406FBF jz short loc 64407004 

.text:64406FC1 cmp eax, 1 

. text: 64406FC4 jz loc 6440708C 

.text:64406FCA cmp eax, 2 

.text:64406FCD jz short loc 64407004 

.text:64406FCF push eax 

.text:64406FD0 push offset aCompressionErr 
"compression error [rc = %d]- program wi"... 

.text:64406FD5 push offset aGui err compre ; 
"GUI ERR COMPRESS" 

.text:64406FDA push dword ptr [edi+28D0h] 

.text:64406FE0 call SapPcTxtRead 


Let's take a look in sub 644055C5. In it we can only see the call to memcpy() and 


another function named (by IDA) sub 64417440. 
And, let's take a look inside sub 64417440. What we see is: 


.text:6441747C push offset aErrorCsrcompre ; 
"\nERROR: CsRCompress: invalid handle" 

.text:64417481 call eax ; dword 644F94C8 

.text:64417483 add esp, 4 


Voilà! We've found the function that actually compresses the data. As it was shown 


in past ?^, 


34http://conus.info/utils/SAP pkt decompr.txt 
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this function is used in SAP and also the open-source MaxDB project. So it is available 
in source form. 


Doing the last check here: 


.text:64406F79 cmp dword ptr [ecx+3A4h], 1 
.text:64406F80 jnz compression flag is zero 


Replace JNZ here for an unconditional JMP. Remove the environment variable TDW NOCOMPRESS. 
Voilà! 

In Wireshark we see that the client messages are not compressed. The server re- 

sponses, however, are compressed. 


So we found exact connection between the environment variable and the point 
where data compression routine can be called or bypassed. 


8.12.2 SAP 6.0 password checking functions 


One time when the author of this book have returned again to his SAP 6.0 IDES 
installed in a VMware box, he figured out that he forgot the password for the SAP* 
account, then he have recalled it, but then he got this error message «Password 
logon no longer possible - too many failed attempts», since he've made all these 
attempts in attempt to recall it. 


The first extremely good news was that the full disp--work.pdb PDB file is supplied 
with SAP, and it contain almost everything: function names, structures, types, local 
variable and argument names, etc. What a lavish gift! 


There is TYPEINFODUMP?? utility for converting PDB files into something readable 
and grepable. 


Here is an example of a function information + its arguments + its local variables: 


FUNCTION ThVmcSysEvent 
Address: 10143190 Size: 675 bytes Index: 60483 2 
y Typelndex: 60484 
Type: int NEAR C ThVmcSysEvent (unsigned int, unsigned char, unsigned 7 
y short*) 
Flags: 0 
PARAMETER events 
Address: Reg335+288 Size: 4 bytes Index: 60488 TypeIndex: Y 
S 60489 
Type: unsigned int 
Flags: do 
PARAMETER opcode 
Address: Reg335+296 Size: 1 bytes Index: 60490 Typelndex: " 
V 60491 
Type: unsigned char 
Flags: do 
PARAMETER serverName 
Address: Reg335+304 Size: 8 bytes Index: 60492 Typelndex: 2 
S 60493 


35http://www.debuginfo.com/tools/typeinfodump.html 
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Type: unsigned short* 
Flags: do 
STATIC LOCAL VAR func 
Address: 12274af0 Size: 8 bytes Index: 60495 2 
S TypeIndex: 60496 
Type: wchar t* 
Flags: 80 
LOCAL VAR admhead 
Address: Reg335+304 Size: 8 bytes Index: 60498 Typelndex: 4 
Y 60499 
Type: unsigned char* 
Flags: 90 
LOCAL VAR record 
Address: Reg335+64 Size: 204 bytes Index: 60501 Typelndex: 2 
y 60502 
Type: AD RECORD 
Flags: 90 
LOCAL_VAR adlen 
Address: Reg335+296 Size: 4 bytes Index: 60508 TypeIndex: e 
S 60509 
Type: int 
Flags: 90 


And here is an example of some structure: 


STRUCT DBSL STMTID 
Size: 120 Variables: 4 Functions: O Base classes: 0 
MEMBER moduletype 

Type: DBSL MODULETYPE 

Offset: 0 Index: 3 TypeIndex: 38653 
MEMBER module 

Type: wchar t module[40] 


Offset: 4 Index: 3 TypeIndex: 831 
MEMBER stmtnum 

Type: long 

Offset: 84 Index: 3 TypeIndex: 440 


MEMBER timestamp 
Type: wchar t timestamp[15] 
Offset: 88 Index: 3 TypeIndex: 6612 


Wow! 
Another good news: debugging calls (there are plenty of them) are very useful. 


Here you can also notice the ct /evel global variable**, that reflects the current trace 
level. 


There are a lot of debugging inserts in the disp--work.exe file: 


cmp cs:ct level, 1 
jl short loc 1400375DA 
call DpLock 


36More about trace level: http://help.sap.com/saphelp_nwpi71/helpdata/en/46/ 
962416a5a613e8e10000000a155369/content.htm 
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lea rcx, aDpxxtool4 c ; "dpxxtool4.c" 

mov edx, 4Eh ; line 

call CTrcSaveLocation 

mov r8, cs:func 48 

mov rcx, cs:hdl ; hdl 

lea rdx, aSDpreadmemvalu ; "%s: DpReadMemValue (%d)" 
mov r9d, ebx 


call DpTrcErr 
call DpUnlock 


If the current trace level is bigger or equal to threshold defined in the code here, a 
debugging message is to be written to the log files like dev wO, dev disp, and other 
dev* files. 


Let's try grepping in the file that we have got with the help of the TYPEINFODUMP 
utility: 


cat "disp+work.pdb.d" | grep FUNCTION | grep -i password 


We have got: 


FUNCTION rcui::AgiPassword::DiagISelection 

FUNCTION ssf password encrypt 

FUNCTION ssf password decrypt 

FUNCTION password logon disabled 

FUNCTION dySignSkipUserPassword 

FUNCTION migrate password history 

FUNCTION password is initial 

FUNCTION rcui::AgiPassword::IsVisible 

FUNCTION password distance ok 

FUNCTION get password downwards compatibility 

FUNCTION dySignUnSkipUserPassword 

FUNCTION rcui::AgiPassword: :GetTypeName 

FUNCTION *rcui::AgiPassword::AgiPassword'::°1'::dtor$2 
FUNCTION *rcui: :AgiPassword: :AgiPassword'::°1'::dtor$0 
FUNCTION *rcui: :AgiPassword: :AgiPassword'::°1'::dtor$1 
FUNCTION usm_set_password 

FUNCTION rcui::AgiPassword::TraceTo 

FUNCTION days since last password change 

FUNCTION rsecgrp generate random password 

FUNCTION rcui::AgiPassword::' scalar deleting destructor' 
FUNCTION password attempt limit exceeded 

FUNCTION handle incorrect password 

FUNCTION "rcui::AgiPassword:: scalar deleting destructor''::^1'::dtor$1 
FUNCTION calculate new password hash 

FUNCTION shift password to history 

FUNCTION rcui::AgiPassword::GetType 

FUNCTION found password in history 

FUNCTION 'rcui::AgiPassword::' scalar deleting destructor'':: 1'::dtor$0 
FUNCTION rcui::Agi0bj::IsaPassword 

FUNCTION password idle check 

FUNCTION SlicHwPasswordForDay 

FUNCTION rcui::AgiPassword::IsaPassword 

FUNCTION rcui::AgiPassword::AgiPassword 
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FUNCTION 
FUNCTION 
FUNCTION 
FUNCTION 
FUNCTION 
FUNCTION 


delete user password 

usm set user password 

Password API 

get password change for SSO 
password in USR40 

rsec agrp abap generate random password 


Let's also try to search for debug messages which contain the words «password» 
and «locked». One of them is the string «user was locked by subsequently failed 
password logon attempts» , referenced in 

function password attempt limit exceeded(). 


Other strings that this function can write to a log file are: «password logon attempt 
will be rejected immediately (preventing dictionary attacks)», «failed-logon lock: ex- 
pired (but not removed due to 'read-only' operation)», «failed-logon lock: expired 
=> removed». 


After playing for a little with this function, we noticed that the problem is exactly in it. 
It is called from the chckpass() function —one of the password checking functions. 


First, we would like to make sure that we are at the correct point: 


Run tracer: 


tracer64.exe -a:disp+work.exe bpf=disp+work.exe!chckpass,args:3,unicode 


PID=2236 | TID=2248|(0) disp+work.exe!chckpass (0x202c770, L"Breweredl 2 
(called from 0x1402f1060 (disp+work. 7 


s. 
s. 


", 0x41) 


exelusrexist-0x3c0)) 


PID-2236|TID-2248|(0) disp+work.exe!chckpass -> 0x35 


The call path is: syssigni() -> DylSigni() -> dychkusr() -> usrexist() -> chckpass(). 


The number 0x35 is an error returned in chckpass() at that point: 


.text:00000001402ED567 loc 1402bED567: ; CODE XREF: 
chckpass+B4 
. text: 00000001402ED567 mov rcx, rbx ; usr02 
.text:00000001402ED56A call password idle check 
.text:00000001402ED56F cmp eax, 33h 
.text:00000001402ED572 jz loc 1402EDB4E 
.text:00000001402ED578 cmp eax, 36h 
. text: 00000001402ED57B jz loc 1402EDB3D 
.text:00000001402ED581 xor edx, edx ; 
usr02 readonly 
.text:00000001402ED583 mov rcx, rbx ; usr02 
.text:00000001402ED586 call " 
Y password attempt limit exceeded 
.text:00000001402ED58B test al, al 
.text:00000001402ED58D jz short loc 1402ED5A0 
.text:00000001402ED58F mov eax, 35h 
.text:00000001402ED594 add rsp, 60h 
.text:00000001402ED598 pop r14 
. text: 00000001402ED59A pop r12 
. text: 00000001402ED59C pop rdi 
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.text:00000001402ED59D pop rsi 
.text:00000001402ED59E pop rbx 
.text:00000001402ED59F retn 


Fine, let's check: 


tracer64.exe -a:disp+work.exe bpf=disp+work.exe! 7 
S password attempt limit exceeded,args:4,unicode,rt:0 


PID-2744|TID-360|(0) disp*work.exe!password attempt limit exceeded (07 
V x202c770, 0, 0x257758, 0) (called from 0x1402ed58b (disp+work.exe! 7 
V chckpass+0xeb)) 
PID=2744 | TID=360| (0) disptwork.exe! password attempt limit exceeded -> 1 
PID=2744|TID=360|We modify return value (EAX/RAX) of this function to 0 
PID=2744| TID=360|(0) disptwork.exe! password attempt limit exceeded (07 
V x202c770, 0, 0, 0) (called from 0x1402e9794 (disp+twork.exe! chngpass+07 
S xe4)) 
PID=2744|TID=360|(0) disptwork.exe! password attempt limit exceeded -> 1 
PID=2744|TID=360|We modify return value (EAX/RAX) of this function to 0 


Excellent! We can successfully login now. 


By the way, we can pretend we forgot the password, fixing the chckpass() function 
to return a value of 0 is enough to bypass the check: 


tracer64.exe -a:disp+work.exe bpf=disp+work.exe!chckpass,args:3,unicode, rt / 


S :0 
PID-2744|TID-360|(0) disp+work.exe!chckpass (0x202c770, L"bogus 2 
m ", 0x41) (called from 0x1402f1060 (disp+work. ? 


4 exe! usrexist+0x3c0) ) 
PID-2744|TID-360|(0) disp+work.exe!chckpass -> 0x35 
PID=2744|TID=360|We modify return value (EAX/RAX) of this function to 0 


What also can be said while analyzing the 
password attempt limit exceeded() function is that at the very beginning of it, this 
call can be seen: 


lea rcx, aLoginFailed us ; "login/failed user auto unlock" 
call sapgparam 

test rax, rax 

jz short loc 1402E19DE 
movzx eax, word ptr [rax] 
cmp ax, 'N' 

jz short loc 1402E19D4 
cmp ax, 'n' 

jz short loc 1402E19D4 
cmp ax, '0' 

jnz short loc 1402E19DE 


Obviously, function sapgparam() is used to query the value of some configuration 
parameter. This function can be called from 1768 different places. It seems that 
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with the help of this information, we can easily find the places in code, the control 
flow of which can be affected by specific configuration parameters. 


It is really sweet. The function names are very clear, much clearer than in the Oracle 
RDBMS. 


It seems that the disp-- work process is written in C++. Has it been rewritten some 
time ago? 


8.13 Oracle RDBMS 


8.13.1 V$VERSION table in the Oracle RDBMS 


Oracle RDBMS 11.2 is a huge program, its main module oracle.exe contain ap- 
prox. 124,000 functions. For comparison, the Windows 7 x86 kernel (ntoskrnl.exe) 
contains approx. 11,000 functions and the Linux 3.9.8 kernel (with default drivers 
compiled)—31,000 functions. 


Let's start with an easy question. Where does Oracle RDBMS get all this information, 
when we execute this simple statement in SQL*Plus: 


SQL» select * from V$VERSION; 


And we get: 


BANNER 


Oracle Database 11g Enterprise Edition Release 11.2.0.1.0 - Production 
PL/SQL Release 11.2.0.1.0 - Production 

CORE 11.2.0.1.0 Production 

TNS for 32-bit Windows: Version 11.2.0.1.0 - Production 

NLSRTL Version 11.2.0.1.0 - Production 


Let's start. Where in the Oracle RDBMS can we find the string V$VERSION? 


In the win32-version, oracle.exe file contains the string, it's easy to see. But we 
can also use the object (.0) files from the Linux version of Oracle RDBMS since, unlike 
the win32 version oracle.exe, the function names (and global variables as well) are 
preserved there. 


So, the kqf .o file contains the V$VERSION string. The object file is in the main Oracle- 
library Libserver11.a. 


A reference to this text string can find in the kqfviw table stored in the same file, 
kgf.o: 


Listing 8.10: kqf.o 


.rodata:0800C4A0 kqfviw dd 0Bh ; DATA XREF: kqfchk:loc 8003A6D 
.rodata:0800C4A0 ; kqfgbn+34 

.rodata:0800C4A4 dd offset 2 STRING 10102 0 ; "GVSWAITSTAT" 
.rodata:0800C4A8 dd 4 

.rodata:0800C4AC dd offset 2 STRING 10103 0 ; "NULL" 
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.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 
.Fodata 


:0800C4B0 
:0800C4B4 
:0800C4B8 
:0800C4BC 
:0800C4C0 
:0800C4C4 
:0800C4C8 
:0800C4CC 
:0800C4D0 
:0800C4D4 
:0800C4D8 
:0800C4DC 
:0800C4E0 
:0800C4E4 
:0800C4E8 
:0800C4EC 
:0800C4F0 
:0800C4F4 
:0800C4F8 
:0800C4FC 
:0800C500 
:0800C504 
:0800C508 
:0800C50C 
:0800C510 
:0800C514 
:0800C518 
:0800C51C 
:0800C520 
:0800C524 
:0800C528 
:0800C52C 
:0800C530 
:0800C534 
:0800C538 
:0800C53C 
:0800C540 
:0800C544 
:0800C548 
:0800C54C 
:0800C550 
:0800C554 
:0800C558 
:0800C55C 


3 

0 

195h 

4 

0 

OFFFFCICBh 

3 

0 

0Ah 

offset 2 STRING 10104 0 ; 
4 

offset 2 STRING 10103 0 ; 
3 

0 

4Eh 

3 

0 

OFFFFC003h 

4 


0 

5 

offset 2 STRING 10105 0 ; 
4 

offset 2 STRING 10103 0 ; 
3 

0 

269h 

15h 

0 

OFFFFCIEDh 

8 

0 

4 

offset 2 STRING 10106 0 ; 
4 

offset 2 STRING 10103 0 ; 
3 

0 

OF5h 

14h 

0 

OFFFFCIEEh 

5 

0 


"VS$WAITSTAT" 


" NULL " 


"GV$BH" 


"NULL" 


"V$BH" 


" NULL" 


By the way, often, while analyzing Oracle RDBMS's internals, you may ask yourself, 
why are the names of the functions and global variable so weird. 


Probably, because Oracle RDBMS is a very old product and was developed in C in 
the 1980s. 


And that was a time when the C standard guaranteed that the function names/vari- 
ables can support only up to 6 characters inclusive: «6 significant initial characters 
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in an external identifier»? 


Probably, the table kqfviw contains most (maybe even all) views prefixed with V$, 
these are fixed views, present all the time. Superficially, by noticing the cyclic re- 
currence of data, we can easily see that each kqfviw table element has 12 32-bit 
fields. It is very simple to create a 12-elements structure in IDA and apply it to all 
table elements. As of Oracle RDBMS version 11.2, there are 1023 table elements, 
i.e., in it are described 1023 of all possible fixed views. 


We are going to return to this number later. 


As we can see, there is not much information in these numbers in the fields. The 
first field is always equals to the name of the view (without the terminating zero). 
This is correct for each element. But this information is not very useful. 


We also know that the information about all fixed views can be retrieved from a 
fixed view named V$FIXED VIEW DEFINITION (by the way, the information for this 
view is also taken from the kqfviw and kqfvip tables.) Incidentally, there are 1023 
elements in those too. Coincidence? No. 


SQL> select * from V$FIXED VIEW DEFINITION where view name-'V$VERSION'; 


VIEW NAME 


V$VERSION 
select BANNER from GV$VERSION where inst id - USERENV('Instance') 


So, V$VERSION is some kind of a thunk view for another view, named GV$VERSION, 
which is, in turn: 


SQL> select * from V$FIXED VIEW DEFINITION where view _name='GV$VERSION' ; 


VIEW NAME 


GV$VERSION 
select inst id, banner from x$version 


The tables prefixed with X$ in the Oracle RDBMS are service tables too, undocu- 
mented, cannot be changed by the user and are refreshed dynamically. 


If we search for the text 


select BANNER from GV$VERSION where inst id - 
USERENV (' Instance") 


. in the kqf.o file, we find it in the kqfvip table: 


37Draft ANSI C Standard (ANSI X3J11/88-090) (May 13, 1988) (yurichev.com) 
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Listing 8.11: kqf.o 


.rodata:080185A0 kqfvip dd offset 2 STRING 11126 0 ; DATA XREF: kqfgven+18 
. rodata:080185A0 ; kqfgvt+F 
. rodata:080185A0 : 

"select inst id, decode(indx,1,'data bloc"... 


.rodata:080185A4 dd offset kqfv459 c 0 

.rodata:080185A8 dd 0 

.rodata:080185AC dd 0 

.rodata:08019570 dd offset 2 STRING 11378 0 ; 
"select BANNER from GV$VERSION where in"... 

.rodata:08019574 dd offset kqfv133 c 0 

. rodata: 08019578 dd 0 

. rodata:0801957C dd 0 

. rodata: 08019580 dd offset 2 STRING 11379 0 ; 
"select inst id,decode(bitand(cfflg,1),0"... 

.rodata:08019584 dd offset kqfv403 c 0 

.rodata:08019588 dd 0 

.rodata:0801958C dd 0 

. rodata: 08019590 dd offset 2 STRING 11380 0 ; 
"select STATUS , NAME, IS RECOVERY DEST"... 

. rodata:08019594 dd offset kqfv199 c 0 


The table appear to have 4 fields in each element. By the way, there are 1023 
elements in it, again, the number we already know. 


The second field points to another table that contains the table fields for this fixed 
view. As for V$VERSION, this table has only two elements, the first is 6 and the second 
is the BANNER string (the number 6 is this string's length) and after, a terminating 
element that contains 0 and a null C string: 


Listing 8.12: kqf.o 


.rodata:080BBAC4 kqfv133 c 0 dd 6 ; DATA XREF: .rodata:08019574 
.rodata:080BBAC8 dd offset 2 STRING 5017 0 ; "BANNER" 
.rodata:080BBACC dd 0 

. rodata:080BBADO dd offset 2 STRING 0 0 


By joining data from both kqfviw and kqfvip tables, we can get the SQL statements 
which are executed when the user wants to query information from a specific fixed 
view. 


So we can write an oracle tables?? program, to gather all this information from Oracle 
RDBMS for Linux's object files. For V$VERSION, we find this: 


Listing 8.13: Result of oracle tables 


kqfviw element.viewname: [V$VERSION] ?: 0x3 0x43 0x1 OxffffcO085 0x4 

kqfvip element.statement: [select BANNER from GV$VERSION where inst id = 7 
S USERENV(' Instance')] 

kqfvip element.params: 
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[BANNER] 


And: 


Listing 8.14: Result of oracle tables 


kqfviw element.viewname: [GV$VERSION] ?: 0x3 0x26 0x2 Oxffffc192 0x1 
kqfvip element.statement: [select inst id, banner from x$version] 
kqfvip element.params: 

[INST ID] [BANNER] 


The GV$VERSION fixed view is different from V$VERSION only in that it has one more 
field with the identifier instance. 


Anyway, we are going to stick with the X$VERSION table. Just like any other X$-table, 
it is undocumented, however, we can query it: 


SQL» select * from x$version; 


ADDR INDX INST ID 
BANNER 
ODBAF574 0 1 


Oracle Database 11g Enterprise Edition Release 11.2.0.1.0 - Production 


This table has some additional fields, like ADDR and INDX. 


While scrolling kqf.o in IDA we can spot another table that contains a pointer to the 
X$VERSION string, this is kqftab: 


Listing 8.15: kqf.o 


.Fodata:0803CACO dd 9 ; element number 0x1f6 
.rodata:0803CAC4 dd offset 2 STRING 13113 0 ; "X$VERSION" 
.rodata:0803CAC8 dd 4 

.rodata:0803CACC dd offset 2 STRING 13114 0 ; "kqvt" 
.rodata:0803CADO dd 4 

.rodata:0803CAD4 dd 4 

.rodata:0803CAD8 dd 0 

.rodata:0803CADC dd 4 

.rodata:0803CAE0 dd OCh 

.rodata:0803CAE4 dd OFFFFCO75h 

.rodata:0803CAE8 dd 3 

.rodata:0803CAEC dd 0 

.rodata:0803CAFO dd 7 

.rodata:0803CAF4 dd offset 2 STRING 13115 0 ; "X$KQFSZ" 
.rodata:0803CAF8 dd 5 

.rodata:0803CAFC dd offset 2 STRING 13116 0 ; "kqfsz" 
.rodata:0803CB00 dd 1 

. rodata:0803CB04 dd 38h 

.rodata:0803CB08 dd 0 
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.rodata:0803CBOC dd 7 
.rodata:0803CB10 dd 0 
.Fodata:0803CB14 dd OFFFFCO9Dh 
.Fodata:0803CB18 dd 2 
.rodata:0803CB1C dd 0 


There are a lot of references to the X$-table names, apparently, to all Oracle RDBMS 
11.2 X$-tables. But again, we don't have enough information. 


It's not clear what does the kqvt string stands for. 
The kq prefix may mean kernel or query. 
v apparently stands for version and t—type? Hard to say. 


A table with a similar name can be found in kqf.o: 


Listing 8.16: kqf.o 


.rodata:0808C360 kqvt c 0 kqftap param «4, offset 2 STRING 19 0, 917h, 0,7 
0,0, 4, 0, © 


.rodata:0808C360 ; DATA XREF: 
. rodata: 08042680 

. rodata:0808C360 ; "ADDR" 

. rodata:0808C384 kqftap param «4, offset 2 STRING 20 0, 0B02h, 2 
0, 0, 0, 4, 0, 0» ; 

. rodata:0808C3A8 kqftap param «7, offset 2 STRING 21 0, 0B02h, 2 
0, 0, 0, 4, 0, 0» ; 
"INST ID" 

.rodata:0808C3CC kqftap param <6, offset 2 STRING 5017 0, 601h, 2 
s 0, 0, 0, 50h, 0, © ; 
"BANNER" 

.rodata:0808C3F0 kqftap param «0, offset 2 STRING 0 0, 0,0,0, 7 
0, 0, 0, © 


It contains information about all fields in the X$VERSION table. The only reference to 
this table is in the kqftap table: 


Listing 8.17: kqf.o 


. rodata: 08042680 kqftap element «0, offset kqvt c 0, offset» 
Y kqvrow, 0» ; element 0x1f6 


It is interesting that this element here is Ox1f6th (502nd), just like the pointer to the 
X$VERSION string in the kqftab table. 


Probably, the kqftap and kqftab tables complement each other, just like kqfvip 
and kqfviw. 


We also see a pointer to the kqvrow() function. Finally, we got something useful! 
So we will add these tables to our oracle tables?? utility too. For X$VERSION we get: 
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Listing 8.18: Result of oracle tables 


kqftab element.name: [X$VERSION] ?: [kqvt] 0x4 0x4 0x4 Oxc Oxffffc075 0x3 
kqftap param.name-[ADDR] ?: 0x917 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[INDX] ?: 0xb02 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[INST ID] ?: 0xb02 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[BANNER] ?: 0x601 0x0 0x0 0x0 0x50 0x0 0x0 

kqftap element.fnl-kqvrow 

kqftap element.fn2-NULL 


With the help of tracer, it is easy to check that this function is called 6 times in row 
(from the qerfxFetch() function) while querying the X$VERSION table. 


Let's run tracer in cc mode (it comments each executed instruction): 


tracer -a:oracle.exe bpf=oracle.exe! kqvrow,trace:cc 


 kqvrow proc near 


var 7C - byte ptr -7Ch 
var 18 - dword ptr -18h 
var 14 - dword ptr -14h 
Dest - dword ptr -10h 
var C = dword ptr -OCh 
var 8 - dword ptr -8 

var 4 - dword ptr -4 

arg 8 = dword ptr 10h 
arg C = dword ptr 14h 
arg 14 = dword ptr 1Ch 
arg 18 = dword ptr 20h 


; FUNCTION CHUNK AT .text1:056C11A0 SIZE 00000049 BYTES 


push ebp 

mov ebp, esp 

sub esp, 7Ch 

mov eax, [ebptarg 14] ; [EBP+1Ch]=1 

mov ecx, TlsIndex ; [69AEBO8h]=0 

mov edx, large fs:2Ch 

mov edx, [edx+ecx*4] ; [EDX+ECX*4]=0xc98c938 
cmp eax, 2 ; EAX-1 

mov eax, [ebptarg 8] ; [EBP+10h]=0xcdfe554 
jz loc 2CE1288 

mov ecx, [eax] ; [EAX]=0..5 

mov [ebp+var_4], edi ; EDI-0xc98c938 


loc 2CE10F6: ; CODE XREF: _kqvrow_+10A 
; Kkqvrow +1A9 


cmp ecx, 5 ; ECX=0..5 

ja loc 56C11C7 

mov edi, [ebptarg 18] ; [EBP+20h]=0 
mov [ebp+var_14], edx ; EDX=0xc98c938 
mov [ebprvar 8], ebx ; EBX=0 

mov ebx, eax ; EAX=0xcdfe554 
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mov [ebp*var C], esi ; ESI=0xcdfe248 


loc 2CE110D: ; CODE XREF: _kqvrow_+29EQ0E6 
mov edx, ds:off 628B09C[ecx*4] ; [ECX*4+628B09Ch]=0x2ce1116, 
Ox2cellac, Ox2celldb, Ox2cellf6, 0x2ce1236, 0x2ce127a 
jmp edx ; EDX=0x2ce1116, Ox2cellac, O0x2celldb, 
Ox2cellf6, 0x2ce1236, 0x2ce127a 


loc 2CE1116: ; DATA XREF: .rdata:off 628B09C 
push offset aXKqvvsnBuffer ; "x$kqvvsn buffer" 


mov ecx, [ebptarg C] ; [EBP+14h]=0x8a172b4 

xor edx, edx 

mov esi, [ebp+var_14] ; [EBP-14h]=0xc98c938 

push edx ; EDX=0 

push edx ; EDX=0 

push 50h 

push ecx ; ECX=0x8a172b4 

push dword ptr [esi+10494h] ; [ESI+10494h]=0xc98cd58 

call _kghalf ; tracing nested maximum level (1) reached, 
skipping this CALL 

mov esi, ds: imp vsnnum ; [59771A8h]=0x61bc49e0 

mov [ebp+Dest], eax ; EAX=0xce2ffb0 

mov [ebx+8], eax ; EAX=0xce2ffb0 

mov [ebx+4], eax ; EAX=0xce2ffb0 

mov edi, [esi] ; [ESI]=0xb200100 

mov esi, ds: imp vsnstr ; [597D6D4h]=0x65852148, "- 
Production" 

push esi ; EST=0x65852148, "- Production" 

mov ebx, edi ; EDI=0xb200100 

shr ebx, 18h ; EBX=0xb200100 

mov ecx, edi ; EDI=0xb200100 

shr ecx, 14h ; ECX=0xb200100 

and ecx, OFh ; ECX=0xb2 

mov edx, edi ; EDI=0xb200100 

shr edx, OCh ; EDX=0xb200100 

movzx edx, dl ; DL-0 

mov eax, edi ; EDI=0xb200100 

shr eax, 8 ; EAX=0xb200100 

and eax, OFh ; EAX=0xb2001 

and edi, OFFh ; EDI=0xb200100 

push edi ; EDI=0 

mov edi, [ebp«arg 18] ; [EBP+20h]=0 

push eax ; EAX=1 

mov eax, ds: imp vsnban ; 
[597D6D8h]=0x65852100, "Oracle Database 11g Enterprise Edition Release %d.%d.%d.%d.%d %s" 

push edx ; EDX=0 

push ecx ; ECX=2 

push ebx ; EBX=0xb 

mov ebx, [ebp+arg 8] ; [EBP+10h]=0xcdfe554 

push eax A 
EAX=0x65852100, "Oracle Database 11g Enterprise Edition Release %d.%d.%d. 

mov eax, [ebp+Dest] ; [EBP-10h]=0xce2ffb0 

push eax ; EAX=0xce2ffb0 


call ds: imp sprintf ; op1=MSVCR80.dll!sprintf tracing nested 
maximum level (1) reached, skipping this CALL 


95 


eu. 
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add esp, 38h 
mov dword ptr [ebx], 1 


loc 2CE1192: ; CODE XREF: kqvrow «FB 
; _kqvrow_+128 ... 


test edi, edi ; EDI-0 

jnz . VInfreq kqvrow 

mov esi, [ebp+var C] ; [EBP-0Ch]=0xcdfe248 

mov edi, [ebp+var_4] ; [EBP-4]=0xc98c938 

mov eax, ebx ; EBX=0xcdfe554 

mov ebx, [ebp+var_8] ; [EBP-8]=0 

lea eax, [eax+4] ; [EAX+4]=0xce2ffb0, "NLSRTL Version 


11.2.0.1.0 - Production", "Oracle Database 11g Enterprise Edition Release 
11.2.0.1.0 - Production", "PL/SQL Release 11.2.0.1.0 - Production", "TNS 
for 32-bit Windows: Version 11.2.0.1.0 - Production" 


loc_2CE11A8: ; CODE XREF: _kqvrow +29E00F6 


mov esp, ebp 

pop ebp 

retn ; EAX=0xcdfe558 

loc 2CE11AC: ; DATA XREF: .rdata:0628B0A0 

mov edx, [ebx+8] ; [EBX+8]=0xce2ffb0, "Oracle Database 11g 
Enterprise Edition Release 11.2.0.1.0 - Production" 

mov dword ptr [ebx], 2 

mov [ebx+4], edx ; EDX=0xce2ffb0, "Oracle Database 11g 
Enterprise Edition Release 11.2.0.1.0 - Production" 

push edx ; EDX=0xce2ffb0, "Oracle Database 11g 
Enterprise Edition Release 11.2.0.1.0 - Production" 

call _kkxvsn ; tracing nested maximum level (1) reached, 
skipping this CALL 

pop ecx 

mov edx, [ebx+4] ; [EBX+4]=0xce2ffb0, "PL/SQL Release 


11.2.0.1.0 - Production" 
movzx ecx, byte ptr [edx] ; [EDX]=0x50 


test ecx, ecx ; ECX=0x50 

jnz short loc 2CE1192 

mov edx, [ebp«var 14] 

mov esi, [ebp+var C] 

mov eax, ebx 

mov ebx, [ebp+var_ 8] 

mov ecx, [eax] 

jmp loc 2CE10F6 

loc 2CE11DB: ; DATA XREF: .rdata:0628B0A4 

push 0 

push 50h 

mov edx, [ebx+8] ; [EBX+8]=0xce2ffb0, "PL/SQL Release 
11.2.0.1.0 - Production" 

mov [ebx+4], edx ; EDX=0xce2ffb0, "PL/SQL Release 11.2.0.1.0 
- Production" 

push edx ; EDX=0xce2ffb0, "PL/SQL Release 11.2.0.1.0 
- Production" . 

call _Imxver ; tracing nested maximum level (1) reached, 
skipping this CALL 

add esp, OCh 

mov dword ptr [ebx], 3 
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jmp short loc 2CE1192 
loc _2CE11F6: ; DATA XREF: .rdata:0628B0A8 
mov edx, [ebx+8] ; [EBX+8]=0xce2ffb0 
mov [ebp+var_18], 50h 
mov [ebx+4], edx ; EDX=0xce2ffb0 
push 0 
call  npinli ; tracing nested maximum level (1) reached, 
skipping this CALL 
pop ecx 
test eax, eax ; EAX-0 
jnz loc 56C11DA 
mov ecx, [ebp+var_14] ; [EBP-14h]=0xc98c938 
lea edx, [ebp+var_ 181 ; [EBP-18h]=0x50 
push edx EDX=0xd76c93c 
push dword ptr [ebx+8] ; [EBX+8]=0xce2ffb0 
push dword ptr [ecx+13278h] ; [ECX+13278h]=0xaccel90 
call nrtnsvrs ; tracing nested maximum level (1) reached, 
skipping this CALL 
add esp, OCh 
loc 2CE122B: ; CODE XREF: _kqvrow_+29E0118 
mov dword ptr [ebx], 4 
jmp loc 2CE1192 
loc 2CE1236: ; DATA XREF: .rdata:0628B0AC 
lea edx, [ebp+var_7C] ; [EBP-7Ch]= 
push edx ; EDX=0xd76c8d8 
push 0 
mov esi, [ebx+8] ; [EBX+8]=0xce2ffb0, "TNS for 32-bit 
windows: ee 11.2.0.1.0 - Production" : 
[ebx+4], esi ; ESI=0xce2ffb0, "TNS for 32-bit Windows: 
Version ETI 1.0 - Production" 
mov ecx, 
mov [ebp+var_18], ecx ; ECX=0x50 
push ecx ; ECX=0x50 
push esi ; ESI=0xce2ffb0, "TNS for 32-bit Windows: 
Version 11.2.0.1.0 - Production" . . 
call lxvers ; tracing nested maximum level (1) reached, 
Japo this CALL 
add esp, 10h 
mov edx, [ebp+var_18] ; [EBP-18h]=0x50 
mov dword ptr [ebx], 5 
test edx, edx ; EDX=0x50 
jnz loc 2CE1192 
mov edx, [ebp+var_14] 
mov esi, [ebp+var C] 
mov eax, ebx 
mov ebx, [ebp+var_ 8] 
mov ecx, 5 
jmp loc 2CE10F6 
loc 2CE127A: ; DATA XREF: .rdata:0628B0B0 
mov edx, [ebp+var_14] ; [EBP-14h]=0xc98c938 
mov esi, [ebp+var C] ; [EBP-0Ch]=0xcdfe248 
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mov edi, [ebp+var_4] ; [EBP-4]-0xc98c938 
mov eax, ebx ; EBX=0xcdfe554 
mov ebx, [ebp+var 8] ; [EBP-8]=0 


loc 2CE1288: 


; CODE XREF: _kqvrow_+1F 


mov eax, [eax+8] ; [EAX+8]=0xce2ffb0, "NLSRTL Version 
11.2.0.1.0 - Production" 

test eax, eax ; EAX=0xce2ffb0, "NLSRTL Version 11.2.0.1.0 
- Production" 

jz short loc 2CE12A7 

push offset aXKqvvsnBuffer ; "x$kqvvsn buffer" 

push eax ; EAX=0xce2ffb0, "NLSRTL Version 11.2.0.1.0 
- Production" 

mov eax, [ebptarg C] ; [EBP+14h]=0x8a172b4 

push eax ; EAX-0x8a172b4 

push dword ptr [edx+10494h] ; [EDX+10494h]=0xc98cd58 

call _kghf rf ; tracing nested maximum level (1) reached, 
skipping this CALL 

add esp, 10h 

loc 2CE12A7: ; CODE XREF: _kqvrow_+1C1l 

xor eax, eax 

mov esp, ebp 

pop ebp 

retn ; EAX-0 

 kqvrow | endp 


Now it is easy to see that the row number is passed from outside. The function 
returns the string, constructing it as follows: 


String 1 | Using vsnstr, vsnnum, vsnban global variables. 
Calls sprintf(). 

String 2 | Calls kkxvsn(). 

String 3 | Calls lmxver(). 

String 4 | Calls npinli(), nrtnsvrs(). 

String 5 | Calls lxvers(). 


That's how the corresponding functions are called for determining each module's 
version. 
8.13.2 X$KSMLRU table in Oracle RDBMS 


There is a mention of a special table in the Diagnosing and Resolving Error ORA- 
04031 on the Shared Pool or Other Memory Pools [Video] [ID 146599.1] note: 


There is a fixed table called X$KSMLRU that tracks allocations in 
the shared pool that cause other objects in the shared pool to be aged 
out. This fixed table can be used to identify what is causing the large 
allocation. 

If many objects are being periodically flushed from the shared pool 
then this will cause response time problems and will likely cause library 
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cache latch contention problems when the objects are reloaded into 
the shared pool. 

One unusual thing about the X$KSMLRU fixed table is that the con- 
tents of the fixed table are erased whenever someone selects from the 
fixed table. This is done since the fixed table stores only the largest al- 
locations that have occurred. The values are reset after being selected 
so that subsequent large allocations can be noted even if they were 
not quite as large as others that occurred previously. Because of this 
resetting, the output of selecting from this table should be carefully 
kept since it cannot be retrieved back after the query is issued. 


However, as it can be easily checked, the contents of this table are cleared each 
time it's queried. Are we able to find why? Let's get back to tables we already know: 
kqftab and kqftap which were generated with oracle tables^?'s help, that has all 
information about the X$-tables. We can see here that the ksmlrs() function is 
called to prepare this table's elements: 


Listing 8.19: Result of oracle tables 


kqftab element.name: [X$KSMLRU] ?: [ksmlr] 0x4 0x64 0x11 Oxc OxffffcObb 0x5 
kqftap param.name-[ADDR] ?: 0x917 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[INDX] ?: 0xb02 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[INST ID] ?: 0xb02 0x0 0x0 0x0 0x4 0x0 0x0 
kqftap param.name-[KSMLRIDX] ?: 0xb02 0x0 0x0 0x0 0x4 0x0 0x0 
kqftap param.name-[KSMLRDUR] ?: 0xb02 0x0 0x0 0x0 0x4 0x4 0x0 
kgftap_param.name= [KSMLRSHRPOOL ] ?: 0xb02 0x0 0x0 0x0 0x4 0x8 0x0 
kqftap param.name-[KSMLRCOM] ?: 0x501 0x0 0x0 0x0 0x14 Oxc 0x0 
kqftap param.name-[KSMLRSIZ] ?: 0x2 0x0 0x0 0x0 0x4 0x20 0x0 
kqftap param.name-[KSMLRNUM] ?: 0x2 0x0 0x0 0x0 0x4 0x24 0x0 
kqftap param.name-[KSMLRHON] ?: 0x501 0x0 0x0 0x0 0x20 0x28 0x0 
kqftap param.name-[KSMLROHV] ?: 0xb02 0x0 0x0 0x0 0x4 0x48 0x0 
kqftap param.name-[KSMLRSES] ?: 0x17 0x0 0x0 0x0 0x4 Ox4c 0x0 
kqftap param.name-[KSMLRADU] ?: 0x2 0x0 0x0 0x0 0x4 0x50 0x0 
kqftap param.name-[KSMLRNID] ?: 0x2 0x0 0x0 0x0 0x4 0x54 0x0 
kqftap param.name-[KSMLRNSD] ?: 0x2 0x0 0x0 0x0 0x4 0x58 0x0 
kqftap param.name-[KSMLRNCD] ?: 0x2 0x0 0x0 0x0 0x4 Ox5c 0x0 
kqftap param.name-[KSMLRNED] ?: 0x2 0x0 0x0 0x0 0x4 0x60 0x0 
kqftap element.fnl-ksmlrs 

kqftap element.fn2-NULL 


NYNNNNNN cM coe 


Indeed, with tracer's help it is easy to see that this function is called each time we 
query the X$KSMLRU table. 


Here we see a references to the ksmsplu sp() and ksmsplu jp() functions, each 
of them calls the ksmsplu() at the end. At the end of the ksmsplu() function we 
see a call to memset ( ): 


Listing 8.20: ksm.o 


40vurichev.com 
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.text:00434C50 loc 434C50: ; DATA XREF: .rdata:off 5E50EA8 
.text:00434C50 mov edx, [ebp-4] 
.text:00434C53 mov [eax], esi 
.text:00434C55 mov esi, [edi] 
.text:00434C57 mov [eax+4], esi 
.text:00434C5A mov [edi], eax 
.text:00434C5C add edx, 1 

.text:00434C5F mov [ebp-4], edx 
.text:00434C62 jnz loc 434B7D 
.text:00434C68 mov ecx, [ebp+14h] 
.text:00434C6B mov ebx, [ebp-10h] 
.text:00434C6E mov esi, [ebp-0Ch] 
.text:00434C71 mov edi, [ebp-8] 
.text:00434C74 lea eax, [ecx+8Ch] 

. text: 00434C7A push 370h ; Size 
. text: 00434C7F push 0 ; Val 
.text:00434C81 push eax ; Dst 
.text:00434C82 call _ intel fast memset 
.text:00434C87 add esp, OCh 
.text:00434C8A mov esp, ebp 

. text: 00434C8C pop ebp 

. text: 00434C8D retn 


.text:00434C8D ksmsplu endp 


Constructions like memset (block, 0, size) are often used just to zero memory 
block. What if we take a risk, block the memset () call and see what happens? 


Let's run tracer with the following options: set breakpoint at 0x434C7A (the point 
where the arguments to memset () are to be passed), so that tracer will set program 
counter EIP to the point where the arguments passed to memset () are to be cleared 
(at 0x434C8A) It can be said that we just simulate an unconditional jump from address 
0x434C7A to 0x434C8A. 


tracer -a:oracle.exe bpx=oracle.exe!0x00434C7A,set(eip,0x00434C8A) 


(Important: all these addresses are valid only for the win32 version of Oracle RDBMS 
11.2) 


Indeed, now we can query the X$KSMLRU table as many times as we want and it is 
not being cleared anymore! 


Just in case, do not try this on your production servers. 


It is probably not a very useful or desired system behavior, but as an experiment for 
locating a piece of code that we need, it perfectly suits our needs! 


8.13.3 V$TIMER table in Oracle RDBMS 


V$TIMER is another fixed view that reflects a rapidly changing value: 
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V$TIMER displays the elapsed time in hundredths of a second. Time 
is measured since the beginning of the epoch, which is operating sys- 
tem specific, and wraps around to 0 again whenever the value over- 
flows four bytes (roughly 497 days). 


(From Oracle RDBMS documentation ^!) 


It is interesting that the periods are different for Oracle for win32 and for Linux. Will 
we be able to find the function that generates this value? 


As we can see, this information is finally taken from the X$KSUTM table. 


SQL> select * from V$FIXED VIEW DEFINITION where view name-'V$TIMER'; 


VIEW NAME 


V$TIMER 
select HSECS from GV$TIMER where inst id = USERENV('Instance') 


SQL> select * from V$FIXED VIEW DEFINITION where view name-'GV$TIMER'; 


VIEW NAME 


GV$TIMER 
select inst_id,ksutmtim from x$ksutm 


Now we are stuck in a small problem, there are no references to value generating 
function(s) in the tables kqftab/kqftap: 


Listing 8.21: Result of oracle tables 


kqftab element.name: [X$KSUTM] ?: [ksutm] 0x1 0x4 0x4 0x0 OxffffcO9b 0x3 
kqftap param.name-[ADDR] ?: 0x10917 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[INDX] ?: 0x20b02 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[INST ID] ?: 0xb02 0x0 0x0 0x0 0x4 0x0 0x0 

kqftap param.name-[KSUTMTIM] ?: 0x1302 0x0 0x0 0x0 0x4 0x0 Oxle 

kqftap element.fnl1-NULL 

kqftap element.fn2-NULL 


When we try to find the string KSUTMTIM, we see it in this function: 


kqfd DRN ksutm c proc near ; DATA XREF: .rodata:0805B4E8 
arg © = dword ptr 8 
arg 8 = dword ptr 10h 


^lhttp://docs.oracle.com/cd/B28359 01/server.111/b28320/dynviews 3104.htm 
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arg C - dword ptr 14h 
push ebp 
mov ebp, esp 


push [ebp+arg_C] 

push offset ksugtm 

push offset 2 STRING 1263 0 ; "KSUTMTIM" 
push [ebp+arg_8] 

push [ebp+arg_0] 

call kgfd cfui drain 


add esp, 14h 
mov esp, ebp 
pop ebp 

retn 


kqfd DRN ksutm c endp 


The kqfd DRN ksutm c() function is mentioned in the 
kqfd tab registry 0 table: 


dd offset 2 STRING 62 0 ; "X$KSUTM" 
dd offset kqfd OPN ksutm c 

dd offset kqfd tabl fetch 

dd 0 

dd 0 

dd offset kqfd DRN ksutm c 


There is a function ksugtm() referenced here. Let's see what's in it (Linux x86): 


Listing 8.22: ksu.o 


ksugtm proc near 


var 1C = byte ptr -1Ch 
arg 4 = dword ptr OCh 
push ebp 
mov ebp, esp 
sub esp, 1Ch 
lea eax, [ebp«var 1C] 
push eax 
call slgcs 
pop ecx 
mov edx, [ebptarg 4] 
mov [edx], eax 
mov eax, 4 
mov esp, ebp 
pop ebp 
retn 


ksugtm endp 


The code in the win32 version is almost the same. 


Is this the function we are looking for? Let’s see: 
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tracer -a:oracle.exe bpf=oracle.exe! ksugtm,args:2,dump args:0x4 


Let's try again: 


SQL» select * from V$TIMER; 
27294929 

SQL» select * from V$TIMER; 
27295006 

SQL» select * from V$TIMER; 


27295167 


Listing 8.23: tracer output 


TID=2428|(0) oracle.exe! ksugtm (0x0, Oxd76c5f0) (called from oracle.exe!7 
S  VInfreq gerfxFetch+0xfad (0x56bb6d5)) 


Argument 2/2 
0D76C5F0: 38 C9 
& LLI 


"8. Y 


TID=2428|(0) oracle.exe! ksugtm () -> 0x4 (0x4) 


Argument 2/2 difference 
00000000: D1 7C AO 01 


TID=2428|(0) oracle.exe! ksugtm (0x0, Oxd76c5f0) (called from oracle.exe!^ 
S  VInfreq qerfxFetch«Oxfad (0x56bb6d5)) 


Argument 2/2 
0D76C5F0: 38 C9 
s LLI 


"8. Y 


TID=2428|(0) oracle.exe! ksugtm () -> 0x4 (0x4) 


Argument 2/2 difference 
00000000: 1E 7D AO 01 
Gor 


"bas Y 


TID=2428|(0) oracle.exe! ksugtm (0x0, Oxd76c5f0) (called from oracle.exe! 7 
S  VInfreq gerfxFetch+0xfad (0x56bb6d5)) 


Argument 2/2 
0D76C5F0: 38 C9 
S LLI 


"8. Y 


TID=2428|(0) oracle.exe! ksugtm () -> 0x4 (0x4) 


Argument 2/2 difference 
00000000: BF 7D AO 01 
NL 
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Indeed—the value is the same we see in SQL*Plus and it is returned via the second 


argument. 


Let's see what is in slgcs() (Linux x86): 


slgcs proc near 


var 4 = dword ptr -4 
arg © = dword ptr 8 
push ebp 
mov ebp, esp 
push esi 
mov [ebp-var 4], ebx 
mov eax, [ebp«arg 0] 
call $45 
pop ebx 
nop ; PIC mode 
mov ebx, offset GLOBAL OFFSET TABLE 
mov dword ptr [eax], 0 
call sltrgatime64 ; PIC mode 
push 0 
push OAh 
push edx 
push eax 
call . udivdi3 ; PIC mode 
mov ebx, [ebp+var 4] 
add esp, 10h 
mov esp, ebp 
pop ebp 
retn 
slgcs  endp 


(it is just a call to sltrgatime64() 


and division of its result by 10 (3.12 on page 621)) 


And win32-version: 


_slgcs proc near ; CODE XREF: dbgefgHtElResetCount+15 
; dbgerRunActions+1528 
db 66h 
nop 
push ebp 
mov ebp, esp 
mov eax, [ebp+8] 
mov dword ptr [eax], 0 
call ds: imp GetTickCount@0 ; GetTickCount() 
mov edx, eax 
mov eax, OCCCCCCCDh 
mul edx 
shr edx, 3 
mov eax, edx 
mov esp, ebp 
pop ebp 
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retn 
_slgcs endp 


It is just the result of GetTickCount() * divided by 10 (3.12 on page 621). 


Voilà! That's why the win32 version and the Linux x86 version show different results, 
because they are generated by different OS functions. 


Drain apparently implies connecting a specific table column to a specific function. 


We will add support of the table kqfd tab registry 0 to oracle tables*?, now we 
can see how the table column's variables are connected to a specific functions: 


[X$KSUTM] [kgfd OPN ksutm c] [kqfd tabl fetch] [NULL] [NULL] [7 
V kqfd DRN ksutm c] 

[X$KSUSGIF] [kqfd OPN ksusg c] [kqfd tabl fetch] [NULL] [NULL] [7 
V kqfd DRN ksusg c] 


OPN, apparently stands for, open, and DRN, apparently, for drain. 


8.14 Handwritten assembly code 


8.14.1  EICAR test file 


This .COM-file is intended for testing antivirus software, it is possible to run in in 
MS-DOS and it prints this string: "EICAR-STANDARD-ANTIVIRUS-TEST-FILE!". 


Its important property is that it consists entirely of printable ASCII-symbols, which, 
in turn, makes it possible to create it in any text editor: 


X50! P%@AP [ANPZX54 (P^) 7CC) 7} $EICAR- STANDARD - ANTIVIRUS - TEST - FILE ! $H+H* 


Let’s decompile it: 


; initial conditions: SP=0FFFEh, SS:[SP]=0 


0100 58 pop ax 
; AX=0, SP=0 
0101 35 4F 21 xor ax, 214Fh 
; AX = 214Fh and SP = 0 
0104 50 push ax 
; AX = 214Fh, SP = FFFEh and SS:[FFFE] = 214Fh 
0105 25 40 41 and ax, 4140h 
; AX = 140h, SP = FFFEh and SS:[FFFE] = 214Fh 
0108 50 push ax 
; AX = 140h, SP = FFFCh, SS:[FFFC] = 140h and SS:[FFFE] = 214Fh 
0109 5B pop bx 
; AX = 140h, BX = 140h, SP = FFFEh and SS:[FFFE] = 214Fh 
010A 34 5C xor al, 5Ch 
; AX = 11Ch, BX = 140h, SP = FFFEh and SS:[FFFE] = 214Fh 
010C 50 push ax 
42MSDN 
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010D 5A pop dx 

; AX = 11Ch, BX = 140h, DX = 11Ch, SP = FFFEh and SS:[FFFE] = 214Fh 
010E 58 pop ax 

; AX = 214Fh, BX = 140h, DX = 11Ch and SP = 0 

010F 35 34 28 xor ax, 2834h 

; AX = 97Bh, BX = 140h, DX = 11Ch and SP = 0 

0112 50 push ax 

0113 5E pop si 

; AX = 97Bh, BX = 140h, DX = 11Ch, SI = 97Bh and SP = 0 

0114 29 37 sub [bx], si 

0116 43 inc bx 

0117 43 inc bx 

0118 29 37 sub [bx], si 

011A 7D 24 jge short near ptr word 10140 

011C 45 49 43 ... db 'EICAR-STANDARD - ANTIVIRUS-TEST-FILE!$' 
0140 48 2B word 10140 dw 2B48h ; CD 21 (INT 21) will be here 
0142 48 2A dw 2A48h ; CD 20 (INT 20) will be here 
0144 0D db 0Dh 

0145 0A db  0Ah 


We will add comments about the registers and stack after each instruction. 


Essentially, all these instructions are here only to execute this code: 


B4 09 MOV AH, 9 

BA 1C 01 MOV DX, 11Ch 
CD 21 INT 21h 

CD 20 INT 20h 


INT 21h with 9th function (passed in AH) just prints a string, the address of which 
is passed in DS:DX. By the way, the string has to be terminated with the '$' sign. 
Apparently, it's inherited from CP/M and this function was left in DOS for compatibility. 
INT 20h exits to DOS. 


But as we can see, these instruction's opcodes are not strictly printable. So the main 
part of EICAR file is: 


* preparing the register (AH and DX) values that we need; 
* preparing INT 21 and INT 20 opcodes in memory; 
* executing INT 21 and INT 20. 


By the way, this technique is widely used in shellcode construction, when one have 
to pass x86 code in string form. 


Here is also a list of all x86 instructions which have printable opcodes: .1.6 on 
page 1311. 


8.15 Demos 


Demos (or demomaking) were an excellent exercise in mathematics, computer graph- 
ics programming and very tight x86 hand coding. 
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8.15.1 10 PRINT CHR$(205.5+RND(1)); : GOTO 10 


All examples here are MS-DOS .COM files. 
In [Nick Montfort et al, 20 PRINT CHR$(205.5--RND(1)); : GOTO 10, (The MIT Press:2012)] 
44 


we can read about one of the most simple possible random maze generators. 


It just prints a slash or backslash characters randomly and endlessly, resulting in 
something like this: 


There are a few known implementations for 16-bit x86. 


Trixter's 42 byte version 


The listing was taken from his website^?, but the comments are mine. 


00000000: B001 mov al,1 ; Set 40x25 video mode 
00000002: CD10 int 010 

00000004: 30FF xor bh,bh ; set video page for int 10h 
90000006: B9D007 mov cx ,007D0 ; 2000 characters to output 
00000009: 31C0 xor ax,ax 

0000000B: 9C pushf ; push flags 

; get random value from timer chip 

0000000C: FA cli ; disable interrupts 
0000000D: E643 out 043,al ; write 0 to port 43h 

; read 16-bit value from port 40h 

0000000F: E440 in al,040 


^^Also available as http://trope-tank.mit.edu/10 PRINT 121114.pdf 
^5http://trixter.oldskool.org/2012/12/17/maze-generation-in-thirteen-bytes/ 
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00000011: 88C4 mov ah,al 

00000013: E440 in al,040 

00000015: 9D popf ; enable interrupts by 
restoring IF flag 

00000016: 86C4 xchg ah,al 

; here we have 16-bit pseudorandom value 

00000018: D1E8 shr ax,1 

0000001A: D1E8 shr ax,1 

; CF currently have second bit from the value 

0000001C: BO5C mov al,05C ;'* 

; if CF=1, skip the next instruction 

0000001E: 7202 jc 000000022 

; if CF=0, reload AL register with another character 

00000020: BO2F mov al,02F ;'/' 

; output character 

00000022: B40E mov ah,00E 

00000024: CD10 int 010 

00000026: E2E1 loop 000000009 ; loop 2000 times 

00000028: CD20 int 020 ; exit to DOS 


The pseudo-random value here is in fact the time that has passed from the system's 
boot, taken from the 8253 time chip, the value increases by one 18.2 times per 
second. 


By writing zero to port 43h, we send the command "select counter 0”, "counter 
latch", "binary counter" (not a BCD value). 


The interrupts are enabled back with the POPF instruction, which restores the IF flag 
as well. 


It is not possible to use the IN instruction with registers other than AL, hence the 
shuffling. 


My attempt to reduce Trixter's version: 27 bytes 


We can say that since we use the timer not to get a precise time value, but a pseudo- 
random one, we do not need to spend time (and code) to disable the interrupts. 


Another thing we can say is that we need only one bit from the low 8-bit part, so 
let's read only it. 


We can reduced the code slightly and we've got 27 bytes: 


00000000: B9D007 mov cx,007D0 ; limit output to 2000 characters 


00000003: 31C0 xor ax,ax ; command to timer chip 
00000005: E643 out 043,al 

00000007: E440 in al,040 ; read 8-bit of timer 
00000009: D1E8 shr ax,1 ; get second bit to CF flag 
0000000B: D1E8 shr ax,1 

0000000D: B05C mov al,05C ; prepare '\' 

0000000F: 7202 jc 000000013 

00000011: BO2F mov al,02F ; prepare '/' 

; output character to screen 

00000013: B40E mov ah,00E 
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00000015: CD10 int 010 
00000017: E2EA loop 000000003 
; exit to DOS 

00000019: CD20 int 020 


Taking random memory garbage as a source of randomness 


Since it is MS-DOS, there is no memory protection at all, we can read from whatever 
address we want. Even more than that: a simple LODSB instruction reads a byte from 
the DS:SI address, but it's not a problem if the registers' values are not set up, let 
it read 1) random bytes; 2) from a random place in memory! 


It is suggested in Trixter's webpage^^to use LODSB without any setup. 


It is also suggested that the SCASB instruction can be used instead, because it sets 
a flag according to the byte it reads. 


Another idea to minimize the code is to use the INT 29h DOS syscall, which just 
prints the character stored in the AL register. 


That is what Peter Ferrie did ^: 


Listing 8.24: Peter Ferrie: 10 bytes 


; AL is random at this point 

00000000: AE scasb 

; CF is set according subtracting random memory byte from AL. 
; so it is somewhat random at this point 


00000001: D6 setalc 

; AL is set to OxFF if CF=1 or to 0 if otherwise 

00000002: 242D and al,02D ;'-' 

; AL here is 0x2D or 0 

00000004: 042F add al,02F ; /' 

; AL here is 0x5C or 0x2F 

00000006: CD29 int 029 ; output AL to screen 
00000008: EBF6 jmps 000000000 ; loop endlessly 


So it is possible to get rid of conditional jumps at all. The ASCII code of backslash 
("V") is 0x5C and 0x2F for slash ("/"). So we have to convert one (pseudo-random) 
bit in the CF flag to a value of 0x5C or Ox2F. 


This is done easily: by AND-ing all bits in AL (where all 8 bits are set or cleared) with 
0x2D we have just 0 or 0x2D. 


By adding Ox2F to this value, we get 0x5C or 0x2F. 
Then we just output it to the screen. 


Conclusion 


It is also worth mentioning that the result may be different in DOSBox, Windows NT 
and even MS-DOS, 


^6http://trixter.oldskool.org/2012/12/17/maze-generation-in-thirteen-bytes/ 
47http://pferrie.host22.com/misc/10print.htm 
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8.15.2 Mandelbrot set 


Mathematical Recipes*®has some important notes about Mandelbrot set theory. 


Here is a demo’? written by "Sir Lagsalot” in 2009, that draws the Mandelbrot set, 
which is just a x86 program with executable file size of only 64 bytes. There are only 
30 16-bit x86 instructions. 


Here it is what it draws: 


DOSBox 0.74, Cpu speed: max 100% cycles, Frameskip 0, Program: MICROB~2 


Let's try to understand how it works. 


The demo, although very tiny (just 64 bytes or 30 instructions), implements the 
common algorithm described here, but using some coding tricks. 


The source code is easily downloadable, so here is it, but let's also add comments: 


Listing 8.25: Commented source code 


, 


, 


; X is column on screen 


Y is row on screen 


; X=0, Y=0 X=319, Y=0 


48https://math. recipes 
49D ownload it here, 
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| 

| 

| 

| 

| 
sv 

X=0, Y=199 X=319, Y=199 


; switch to VGA 320*200*256 graphics mode 

mov al,13h 

int 10h 

; initial BX is 0 

; initial DI is OxFFFE 

; DS:BX (or DS:0) is pointing to Program Segment Prefix at this moment 
; ... first 4 bytes of which are CD 20 FF 9F 

les ax,[bx] 

; ES:AX=9FFF: 20CD 


FillLoop: 

; set DX to 0. CWD works as: DX:AX = sign extend(AX). 

; AX here 0x20CD (at startup) or less then 320 (when getting back after 
loop), 

; SO DX will always be 0. 

cwd 

mov ax,di 

; AX is current pointer within VGA buffer 

; divide current pointer by 320 

mov cx,320 

div cx 

; DX (start X) - remainder (column: 0..319); AX - result (row: 0..199) 

sub ax,100 

; AX-AX-100, so AX (start Y) now is in range -100..99 

; DX is in range 0..319 or 0x0000..0x013F 

dec dh 

; DX now is in range OxFF00..0x003F (-256..63) 


xor bx,bx 
xor si,si 
; BX (temp X)20; SI (temp Y)-0 


; get maximal number of iterations 
; CX is still 320 here, so this is also maximal number of iteration 


MandelLoop: 

mov bp,si ; BP = temp_Y 

imul si,bx ; SI = temp X*temp Y 

add si,si ; SI = SI*2 = (temp X*temp Y)*2 
imul bx,bx ; BX = BX^2 = temp X^2 

jo MandelBreak ; overflow? 

imul bp,bp ; BP = BP^2 = temp Y^2 

jo MandelBreak ; overflow? 

add bx,bp ; BX = BX+BP = temp X^2 + temp Y^2 
jo MandelBreak ; overflow? 

sub bx,bp ; BX = BX-BP = temp X^2 + temp Y^2 - temp Y^2 = temp X^2 
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sub bx,bp ; BX = BX-BP = temp X^2 - temp Y^2 
; correct scale: 

sar bx,6 ; BX=BX/64 

add bx,dx ; BX=BX+start X 

; now temp X = temp X^2 - temp Y^2 + start X 

sar si,6 ; SI-SI/64 

add si,ax ; SI=SI+start Y 


; now temp Y = (temp X*temp Y)*2 + start Y 
loop MandelLoop 


MandelBreak: 

; CX=iterations 

xchg ax,cx 

; AX=iterations. store AL to VGA buffer at ES: [DI] 

stosb 

; stosb also increments DI, so DI now points to the next point in VGA buffer 
; jump always, so this is eternal loop here 

jmp FillLoop 


The algorithm: 
e Switch to 320*200 VGA video mode, 256 colors. 320 + 200 = 64000 (OxFAO0). 


Each pixel is encoded by one byte, so the buffer size is OxFAOO bytes. It is 
addressed using the ES:DI registers pair. 


ES must be 0xA000 here, because this is the segment address of the VGA video 
buffer, but storing 0xAO000 to ES requires at least 4 bytes (PUSH 0A000h / POP 
ES). You can read more about the 16-bit MS-DOS memory model here: 11.7 on 
page 1264. 


Assuming that BX is zero here, and the Program Segment Prefix is at the zeroth 
address, the 2-byte LES AX, [BX] instruction stores Ox20CD to AX and Ox9FFF 
to ES. 


So the program starts to draw 16 pixels (or bytes) before the actual video buffer. 
But this is MS-DOS, 


there is no memory protection, so a write happens into the very end of conven- 
tional memory, and usually, there is nothing important. That's why you see a 
red strip 16 pixels wide at the right side. The whole picture is shifted left by 16 
pixels. This is the price of saving 2 bytes. 


An infinite loop processes each pixel. 


Probably, the most common way to enumerate all pixels on the screen is with 
two loops: one for the X coordinate, another for the Y coordinate. But then you'll 
need to multiply the coordinates to address a byte in the VGA video buffer. 


The author of this demo decided to do it otherwise: enumerate all bytes in the 
video buffer by using one single loop instead of two, and get the coordinates of 
the current point using division. The resulting coordinates are: X in the range 
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of -256..63 and Y in the range of -100..99. You can see on the screenshot that the 
picture is somewhat shifted to the right part of screen. 


That's because the biggest heart-shaped black hole usually appears on coordi- 
nates 0,0 and these are shifted here to right. Could the author just subtract 160 
from the value to get X in the range of -160..159? Yes, but the instruction SUB 
DX, 160 takes 4 bytes, while DEC DH—2 bytes (which subtracts 0x100 (256) 
from DX). So the whole picture is shifted for the cost of another 2 bytes of 
saved space. 


- Check, if the current point is inside the Mandelbrot set. The algorithm is 
the one that has been described here. 


The loop is organized using the LOOP instruction, which uses the CX register 
as counter. 


The author could set the number of iterations to some specific number, but 
he didn't: 320 is already present in CX (has been set at line 35), and this is 
good maximal iteration number anyway. We save here some space by not 
the reloading CX register with another value. 


IMUL is used here instead of MUL, because we work with signed values: keep 
in mind that the 0,0 coordinates has to be somewhere near the center of 
the screen. 


It's the same with SAR (arithmetic shift for signed values): it's used instead 
of SHR. 


Another idea is to simplify the bounds check. We must check a coordinate 
pair, i.e., two variables. What the author does is to checks thrice for over- 
flow: two squaring operations and one addition. 


Indeed, we use 16-bit registers, which hold signed values in the range of 
-32768..32767, so if any of the coordinates is greater than 32767 during 
the signed multiplication, this point is definitely out of bounds: we jump to 
the MandelBreak label. 


- There is also a division by 64 (SAR instruction). 64 sets scale. 


Try to increase the value and you can get a closer look, or to decrease if 
for a more distant look. 


* We are at the MandelBreak label, there are two ways of getting here: the loop 
ended with CX=0 ( the point is inside the Mandelbrot set); or because an over- 
flow has happened (CX still holds some value). Now we write the low 8-bit part 
of CX (CL) to the video buffer. 


The default palette is rough, nevertheless, 0 is black: hence we see black holes 
in the places where the points are in the Mandelbrot set. The palette can be 
initialized at the program's start, but keep in mind, this is only a 64 bytes pro- 
gram! 


The program runs in an infinite loop, because an additional check where to stop, 
or any user interface will result in additional instructions. 


Some other optimization tricks: 
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* The 1-byte CWD is used here for clearing DX instead of the 2-byte XOR DX, DX 
or even the 3-byte MOV DX, 0. 


The 1-byte XCHG AX, CX is used instead of the 2-byte MOV AX,CX. The current 
value of AX is not needed here anyway. 


DI (position in video buffer) is not initialized, and it is OXFFFE at the start °°. 


That's OK, because the program works for all DI in the range of 0..0xFFFF eter- 
nally, and the user can't notice that it is started off the screen (the last pixel of 
a 320*200 video buffer is at address OxF9FF). So some work is actually done 
off the limits of the screen. 


Otherwise, you'll need an additional instructions to set DI to O and check for 
the video buffer's end. 


My "fixed" version 


Listing 8.26: My "fixed" version 


org 100h 
mov al,13h 
int 10h 


; Set palette 

mov dx, 3c8h 

mov al, 0 

out dx, al 

mov cx, 100h 

inc dx 

100: 

mov al, cl 

shl ax, 2 

out dx, al ; red 
out dx, al ; green 
out dx, al ; blue 
loop 100 


push 0a000h 
pop es 


xor di, di 


FillLoop: 

cwd 

mov ax,di 

mov cx,320 
div cx 

sub ax,100 
sub dx,160 


xor bx,bx 


50More information about initial register values: https://code.google.com/p/corkami/wiki/ 
InitialValues#D0S 
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xor si,si 


MandelLoop: 
mov bp,si 

imul si,bx 

add si,si 

imul bx,bx 

jo MandelBreak 
imul bp,bp 

jo MandelBreak 
add bx,bp 

jo MandelBreak 
sub bx,bp 

sub bx,bp 


sar bx,6 
add bx,dx 
sar si,6 
add si,ax 


loop MandelLoop 


MandelBreak: 
xchg ax,cx 
stosb 

cmp di, OFAO00h 
jb FillLoop 


; wait for keypress 
xor ax,ax 

int 16h 

; set text video mode 
mov ax, 3 

int 10h 

; exit 

int 20h 


The author of these lines made an attempt to fix all these oddities: now the palette is 
smooth grayscale, the video buffer is at the correct place (lines 19..20), the picture 
is drawn on center of the screen (line 30), the program eventually ends and waits 
for the user's keypress (lines 58..68). 


But now it's much bigger: 105 bytes (or 54 instructions) ?!. 


51You can experiment by yourself: get DosBox and NASM and compile it as: nasm file.asm -fbin -o 
file.com 
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DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: MY — 


Figure 8.18: My "fixed" version 


See also: a small C program printing Mandelbrot set in ASCII: https://people.sc. 
fsu.edu/-jburkardt/c src/mandelbrot ascii/mandelbrot ascii.html 
https://miyuki.github.io/2017/10/04/gcc-archaeology-1.html. 


8.16 A nasty bug in MSVCRT.DLL 


This is the bug that costed me several hours of debugging. 


In 2013 | was using MinGW, my C project seems to be very unstable and | saw the 
“Invalid parameter passed to C runtime function." error message in debugger. 


The error message was also visible using Sysinternals DebugView. And my project 
has no such error messages or strings. So | started to search it in the whole Windows 
and found in MSVCRT.DLL file. (Needless to say | was using Windows 7.) 


So here it is, the error message in MSVCRT.DLL file supplied with Windows 7: 


.text:6FFB69DO OutputString db 'Invalid parameter passed to C runtime 2 
4 function.',0Ah,0 

. text: 6FFB69D0 ; DATA XREF: 
sub 6FFB6930+83 


Where it is referenced? 
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.text:6FFB6930 sub 6FFB6930 proc near ; 
CODE XREF: _wfindfirst64+203FC 
.text:6FFB6930 ; Sub 6FF62563+319AD 
.text:6FFB6930 
.text:6FFB6930 var 2D0 = dword ptr -2D0h 
.text:6FFB6930 var 244 - word ptr -244h 
.text:6FFB6930 var 240 - word ptr -240h 
.text:6FFB6930 var 23C = word ptr -23Ch 
.text:6FFB6930 var 238 = word ptr -238h 
.text:6FFB6930 var 234 = dword ptr -234h 
.text:6FFB6930 var 230 = dword ptr -230h 
.text:6FFB6930 var 22C = dword ptr -22Ch 
.text:6FFB6930 var 228 - dword ptr -228h 
.text:6FFB6930 var 224 - dword ptr -224h 
.text:6FFB6930 var 220 - dword ptr -220h 
.text:6FFB6930 var 21C = dword ptr -21Ch 
.text:6FFB6930 var 218 = dword ptr -218h 
.text:6FFB6930 var 214 - word ptr -214h 
.text:6FFB6930 var 210 - dword ptr -210h 
.text:6FFB6930 var 20C - dword ptr -20Ch 
.text:6FFB6930 var 208 = word ptr -208h 
.text:6FFB6930 var 4 - dword ptr -4 
.text:6FFB6930 
.text:6FFB6930 mov edi, edi 
.text:6FFB6932 push ebp 
.text:6FFB6933 mov ebp, esp 
.text:6FFB6935 sub esp, 2DOh 
. text: 6FFB693B mov eax, | security cookie 
.text:6FFB6940 xor eax, ebp 
.text:6FFB6942 mov [ebp-var 4], eax 
.text:6FFB6945 mov [ebp-var 220], eax 
. text : 6FFB694B mov [ebp+var_224], ecx 
. text: 6FFB6951 mov [ebp+var_228], edx 
. text: 6FFB6957 mov [ebp+var_22C], ebx 
. text: 6FFB695D mov [ebp+var_230], esi 
. text: 6FFB6963 mov [ebp+var_234], edi 
. text: 6FFB6969 mov [ebp+var_208], ss 
. text: 6FFB696F mov [ebp+var_214], cs 
. text: 6FFB6975 mov [ebp+var_238], ds 
. text: 6FFB697B mov [ebp+var_23C], es 
. text: 6FFB6981 mov [ebp+var_240], fs 
. text: 6FFB6987 mov [ebp+var_244], gs 
. text: 6FFB698D pushf 
. text: 6FFB698E pop [ebp+var_210] 
. text: 6FFB6994 mov eax, [ebp+4] 
. text: 6FFB6997 mov [ebp-var 218], eax 
.text:6FFB699D lea eax, [ebp+4] 
. text : 6FFB69A0 mov [ebp+var_2D0], 10001h 
. text: 6FFBO9AA mov [ebp+var_20C], eax 
. text : 6FFB69B0 mov eax, [eax-4] 
.text:6FFB69B3 push offset OutputString ; "Invalid 
parameter passed to C runtime f"... 
.text:6FFB69B8 mov [ebp+var_21C], eax 
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.text:6FFB69BE call ds:OutputDebugStringA 

. text : 6FFB69C4 mov ecx, [ebp+var_4] 

. text: 6FFB69C7 xor ecx, ebp 

. text: 6FFB69C9 call @ security check cookies ; 
security check cookie(x) 

. text : 6FFB69CE leave 

. text: 6FFB69CF retn 

.text:6FFB69CF sub 6FFB6930 endp 


The string it reported into debugger or DebugView utility using the standard OutputDebugStringA() 
function. How the sub 6FFB6930 can be called? IDA shows at least 280 references. 


Using my tracer, | set a breakpoint at sub 6FFB6930 to see, when it's called in my 
case: 


tracer.exe -l:1.exe bpf=msvcrt.dll!0x6FFB6930 -s 


PID=3560|New process 1.exe 

(0) msvcrt.d11!0x6ffb6930() (called from msvcrt.dll! ftol2 sse excpt+0v 
S X1b467 (0x759ed222)) 

Call stack: 

return address=0x401010 (1.exe!.text+0x10), arguments in stack: 0x12ff14, 07 
y x401010, 0x403010("asd"), 0x0, 0x12ff88, 0x4010f8 

return address=0x4010f8 (1.exe!0EP+0xe3), arguments in stack: 0x12ff88, Ov 
V x4010f8, 0x1, 0x2e0ea8, 0x2e1640, 0x403000 

return address=0x75b6ef3c (KERNEL32.dll!BaseThreadInitThunk40x12), 7 
y arguments in stack: 0x12ff94, Ox75b6ef3c, Ox7ffdf000, Ox12ffd4, Ov 
S x77523688, 0x7ffdf000 

return address=0x77523688 (ntdll.dll!RtlInitializeExceptionChain4Oxef), 7 
V arguments in stack: 0x12ffd4, 0x77523688, Ox7ffdf000, 0x74117ec7, 0x02 
V , 0x0 

return address=0x7752365b (ntd11.d11!RtlInitializeExceptionChain+0xc2), 2 
ú arguments in stack: 0x12ffec, 0x7752365b, 0x401015, Ox7ffdf000, 0x0, 7 
y 0x0 

(0) msvcrt.dll! 0x6ffb6930() -> 0x12f94c 

PID=3560|Process 1.exe exited. ExitCode=2147483647 (Ox7fffffff) 


| found that my code was calling stricmp() function with NULL as one argument. In 
fact, | made up this example when writing this: 


#include <stdio.h> 
#include <string.h> 


int main() 


{ 
F; 


stricmp ("asd", NULL); 


If this piece of code is compiled using old MinGW or old MSVC 6.0, itis linked against 
MSVCRT.DLL file. Which, as of Windows 7, silently sends the "Invalid parameter 
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passed to C runtime function." error message to the debugger and then does noth- 
ing! 

Let's see how stricmp() is implemented in MSVCRT.DLL: 


.text:6FF5DB38 ; Exported entry 855. strcmpi 
.text:6FF5DB38 ; Exported entry 863. stricmp 
.text:6FF5DB38 

.text:6FF5DB38 ; =============== SUBROUTINE 


. text: 6FF5DB38 

.text:6FF5DB38 ; Attributes: bp-based frame 

. text: 6FF5DB38 

.text:6FF5DB38 ; int _ cdecl strcmpi(const char *, const char *) 


.text:6FF5DB38 public strcmpi 

.text:6FF5DB38 strcmpi proc near ; CODE XREF: 
LocaleEnumP roc -2B 

. text: 6FF5DB38 ; LocaleEnumProc+5E 


. text: 6FF5DB38 
.text:6FF5DB38 arg 0 
.text:6FF5DB38 arg 4 
.text:6FF5DB38 
.text:6FF5DB38 ; FUNCTION CHUNK AT .text:6FF68CFD SIZE 00000012 BYTES 
.text:6FF5DB38 ; FUNCTION CHUNK AT .text:6FF9D20D SIZE 00000022 BYTES 
.text:6FF5DB38 


dword ptr 8 
dword ptr OCh 


. text: 6FF5DB38 mov edi, edi ; Strcmpi 

. text: 6FF5DB3A push ebp 

. text: 6FF5DB3B mov ebp, esp 

. text: 6FF5DB3D push esi 

.text:6FF5DB3E xor esi, esi 

.text:6FF5DB40 cmp dword 6FFF0000, esi 

.text:6FF5DB46 jnz loc 6FF68CFD 

. text: 6FF5DB4C cmp [ebpt+arg 0], esi ; is arg 0--NULL? 
. text: 6FF5DB4F jz loc_6FF9D20D 

. text: 6FF5DB55 cmp [ebpt+arg 4], esi ; is arg 0--NULL? 
. text: 6FF5DB58 jz loc_6FF9D20D 

. text: 6FF5DB5E pop esi 

. text: 6FF5DB5F pop ebp 

.text:6FF5DB5F strcmpi endp ; sp-analysis failed 


Actual strings comparison here: 


.text:6FF5DB60 sub 6FF5DB60 proc near ; CODE XREF: 
stricmp 1+16C7F 
.text:6FF5DB60 ; Sub 6FFD19CD+229 


.text:6FF5DB60 


.text:6FF5DB60 arg 0 - dword ptr 8 
.text:6FF5DB60 arg 4 = dword ptr 0Ch 

. text: 6FF5DB60 

.text:6FF5DB60 push ebp 
.text:6FF5DB61 mov ebp, esp 
.text:6FF5DB63 push edi 
.text:6FF5DB64 push esi 

. text: 6FF5DB65 push ebx 

. text: 6FF5DB66 mov esi, [ebp+arg 4] 
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. text: 6FF5DB69 
. text: 6FF5DB6C 
. text: 6FF5DB6E 
. text: 6FF5DB70 
.text:6FF5DB70 loc 6FF5DB70: 
sub 6FF5DB60+20 
.text:6FF5DB70 
.text:6FF5DB70 
.text:6FF5DB72 
.text:6FF5DB74 
.text:6FF5DB76 
.text:6FF5DB79 
.text:6FF5DB7B 
.text:6FF5DB7E 
.text:6FF5DB80 
. text: 6FF5DB82 
.text:6FF5DB84 
. text: 6FF5DB86 
. text: 6FF5DB88 
.text:6FF5DB8B 
. text: 6FF5DB8D 
. text: 6FF5DB8F 
. text: 6FF5DB91 
. text: 6FF5DB93 
. text: 6FF5DB95 
. text: 6FF5DB97 
. text: 6FF5DB9A 
. text: 6FF5DB9C 
. text: 6FF5DB9E 
. text: 6FF5DBA0 
. text: 6FF5DBA2 
. text: 6FF5DBA4 
. text: 6FF5DBA6 
.text:6FF5DBA6 loc 6FF5DBA6: 
sub 6FF5DB60+12 
. text: 6FF5DBA6 
. text: 6FF5DBA9 
. text: 6FF5DBAA 
. text: 6FF5DBAB 
. text: 6FF5DBAC 
. text: 6FF5DBAD 
.text:6FF5DBAD sub 6FF5DB60 


.text:6FF68D0C loc 6FF68D60C: 
strcmpi-3F6F2 

.text:6FF68D0C 

.text:6FF68D0D 

. text: 6FF68D0E 


.text:6FF9D20D loc 6FF9D20D: 
strcmpi-17 

.text:6FF9D20D 

. text: 6FF9D20D 

.text:6FF9D212 


mov 
mov 
mov 


or 
jz 
mov 
add 
mov 
add 
cmp 
jz 
sub 
cmp 
sbb 
and 
add 
add 
xchg 
sub 
cmp 
sbb 
and 
add 
add 
cmp 
jz 
sbb 
sbb 


movsx 
pop 
pop 
pop 
leave 
retn 
endp 


pop 
pop 
retn 


call 
push 


edi, [ebptarg 0] 
al, OFFh 
edi, edi 


; CODE XREF: 


; sub 6FF5DB60+40 
al, al 
short loc_6FF5DBA6 
al, [esi] 
esi, 1 
ah, [edi] 
edi, 1 
ah, al 
short loc 6FF5DB70 
al, 41h 
al, 
cl, cl 
cl, 
al, cl 
al, 
ah, al 
al, 
al, 


al, ah 

short loc 6FF5DB70 
al, al 

al, OFFh 


; CODE XREF: 


eax, al 
ebx 
esi 
edi 


; CODE XREF: 


esi 
ebp 


; CODE XREF: 


; strcmpi+20 
near ptr _errno 
esi 
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. text: 6FF9D213 push 
. text: 6FF9D214 push 
. text: 6FF9D215 push 
. text: 6FF9D216 push 
. text: 6FF9D217 mov 
. text: 6FF9D21D call 
. text: 6FF9D222 add 
. text: 6FF9D225 mov 
.text:6FF9D22A jmp 


esi 

esi 

esi 

esi 

dword ptr [eax], 16h 
invalid parameter 
esp, 14h 

eax, 7FFFFFFFh 

loc 6FF68DO0C 


Now the invalid parameter() function: 


. text: 6FFB6A06 
.text:6FFB6A06 invalid parameter proc 
sub 6FF5B494:loc 6FF5B618 
. text: 6FFB6A06 
sub 6FF5CCFD:loc 6FF5C8A2 


. text: 6FFB6A06 mov 
. text: 6FFB6A08 push 
. text: 6FFB6A09 mov 
. text: 6FFB6A0B pop 
. text: 6FFB6A0C jmp 
.text:6FFB6A0C invalid parameter endp 


public _ 


invalid parameter 


near ; CODE XREF: 


edi, edi 

ebp 

ebp, esp 

ebp 
sub_6FFB6930 


The invalid parameter() function eventually calls the function with OutputDebugStringA( ): 


8.16 on page 1162. 


You see, the stricmp() code is like: 


int stricmp(const char *s1, const char 


if (sl==NULL || s2==NULL) 

{ 
// print error message 
return Ox7FFFFFFFh; 

$; 

// do comparison 


y 


*s2, size t len) 


AND exit: 


How come this error is rare? Because newer MSVC versions links against MSVCR120.DLL 


file, etc (where 120 is version number). 


Let's peek inside the newer MSVCR120.DLL from Windows 7: 


. text: 1002A0D4 public stricmp l 

.text:1002A0D4 stricmp 1l proc near ; CODE XREF: 
stricmp+18 

. text: 1002A0D4 ; mbsicmp 1+47 

.text:1002A0D4 ; DATA XREF: 

. text: 1002A0D4 

.text:1002A0D4 var 10 - dword ptr -10h 

.text:1002A0D4 var 8 = dword ptr -8 

.text:1002A0D4 var 4 = byte ptr -4 

.text:1002A0D4 arg 0 - dword ptr 8 
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.text:1002A0D4 arg 4 
.text:1002A0D4 arg 8 
.text:1002A0D4 
.text:1002A0D4 ; 
.text:1002A0D4 
.text:1002A0D4 
.text:1002A0D5 
.text:1002A0D7 
.text:1002A0DA 
.text:1002A0DD 
. text: 1002A0DE 
. text: 1002A0DF 
. text: 1002A0E0 
. text: 1002A0E3 
. text: 1002A0E8 
. text: 1002A0EB 
. text: 1002A0ED 
. text: 1002A0F3 
. text: 1002A0F6 
. text: 1002A0F8 
. text: 1002A0FE 
. text: 1002A101 
. text: 1002A108 
. text: 1002A10E 


.text:1005AA7B loc 1005AA7B: 
stricmp 1+19 
.text:1005AA7B 
.text:1005AA7B 
.text:1005AA80 
.text:1005AA86 
.text:1005AA8B 
.text:1005AA90 


.text:100A4670 invalid parameter noinfo proc near f 


sub 10013BEC-10F 
.text:100A4670 
.text:100A4670 
.text:100A4672 
.text:100A4673 
.text:100A4674 
.text:100A4675 
.text:100A4676 
.text:100A4677 
.text:100A467C 
.text:100A467F 


dword ptr  OCh 
dword ptr 10h 


FUNCTION CHUNK AT .text:1005AA7B SIZE 0000002A BYTES 


push ebp 

mov ebp, esp 

sub esp, 10h 

lea ecx, [ebp«var 10] 
push ebx 

push esi 

push edi 

push [ebp+arg_ 8] 


call sub 1000F764 
mov edi, [ebp*arg 0] ; arg==NULL? 
test edi, edi 
jz loc 1005AA7B 
mov ebx, [ebptarg 4] ; arg==NULL? 
test ebx, ebx 
jz loc 1005AA7B 
mov eax, [ebp+var_10] 
cmp dword ptr [eax+0A8h], 0 
jz loc 1005AA95 
sub edi, ebx 
; CODE XREF: 
; Stricmp 1+24 
call _errno 
mov dword ptr [eax], 16h 
call invalid parameter noinfo 
mov esi, 7FFFFFFFh 
jmp loc 1002A13B 


CODE XREF: 


; sub 10016COF-10F 


xor eax, eax 
push eax 

push eax 

push eax 

push eax 

push eax 

call invalid parameter 
add esp, 14h 

retn 


.text:100A467F invalid parameter noinfo endp 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


1168 


.text:100A4645 invalid parameter proc near ; 


CODE XREF: 


invalid parameter(ushort const *,ushort const *,ushort const 


* uint,uint) 
.text:100A4645 

invalid parameter noinfo-7 
.text:100A4645 
.text:100A4645 
.text:100A4645 
.text:100A4645 
.text:100A4645 
.text:100A4645 
.text:100A4645 
.text:100A4645 
.text:100A4646 
.text:100A4648 
.text:100A464E 
:100A4654 
:100A4656 
:100A4658 
:100A4659 
:100A465B ; 


:100A465B 
.text:100A465B loc 100A465B: 
invalid parameter+11 
.text:100A465B 
.text:100A465E 
.text:100A4661 
.text:100A4664 
.text:100A4667 


arg 0 
arg 4 
arg 8 
arg C 
arg 10 


. text: 100A466A 
. text: 100A466F 


.text:100A466F invalid parameter endp 


.text:100A469B invoke watson 
sub 1002CDB0+27068 

.text:100A469B 

.text:100A469B 

.text:100A469D 

. text: 100A46A2 

. text: 100A46A4 

. text: 100A46A6 

. text: 100A46A8 

. text: 100A46A9 
RtlFailFast(ecx) 

.text:100A46AB ; 

. text: 100A46AB 

.text:100A46AB loc _100A46AB: 

invoke _watson+9 

100A46AB 

100A46AC 

100A46AE 

100A46B3 

100A46B4 


.text: 
.text: 
.text: 
.text: 
.text: 


, 


= dword ptr 8 
= dword ptr OCh 
= dword ptr 10h 
= dword ptr 14h 
- dword ptr 18h 
push ebp 
mov ebp, esp 
push dword 100EO0ED8 ; Ptr 
call ds:DecodePointer 
test eax, eax 
jz short loc 100A465B 
pop ebp 
jmp eax 
; CODE XREF: 
push [ebp+arg_10] 
push [ebp+arg_C] 
push [ebp+arg_8] 
push [ebp+arg 4] 
push [ebp+arg_ 0] 
call invoke watson 
int 3 ; Trap to Debugger 
proc near ; CODE XREF: 
; sub_10029704+2A792 
push 17h ; ProcessorFeature 
call IsProcessorFeaturePresent 
test eax, eax 
jz short loc 100A46AB 
push 5 
pop ecx 
int 29h ; Win8 
; CODE XREF: 
push esi 
push 1 
mov esi, 0C0000417h 
push esi 
push 2 
call sub 100A4519 


.text:100A46B6 
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.text:100A46BB push esi ; uExitCode 
.text:100A46BC call . crtTerminateProcess 
.text:100A46C1 add esp, 10h 

. text: 100A46C4 pop esi 

. text: 100A46C5 retn 


.text:100A46C5 invoke watson endp 


Now the invalid parameter() function is rewritten in newer MSVCR*.DLL version, 
it shows the message box, if you want to kill the process or call debugger. Of course, 
this is much better than silently return. Perhaps, Microsoft forgot to fix MSVCRT.DLL 
since then. 


But how it was working in the era of Windows XP? It wasn't: MSVCRT.DLL from Win- 
dows XP doesn't check arguments against NULL. So under Windows XP my stricmp ("asd", NULL) 
code will crash, and this is good. 


My hypothesis: Microsoft upgraded MSVCR*.DLL files (including MSVCRT.DLL) for 
Windows 7 by adding sanitizing checks everywhere. However, since MSVCRT.DLL 
wasn't used much since MSVS .NET (year 2002), it wasn't properly tested and the 
bug left here. But compilers like MinGW can still use this DLL. 


What would | do without my reverse engineering skills? 
The MSVCRT.DLL from Windows 8.1 has the same bug. 


8.17 Other examples 


An example about Z3 and manual decompilation was here. It is moved there: https: 
//sat-smt.codes. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Examples of reversing 
proprietary file formats 


9.1 Primitive XOR-encryption 


9.1.1 Simplest ever XOR encryption 


| once saw a software where all debugging messages has been encrypted using XOR 
by value of 3. In other words, two lowest bits of each character has been flipped. 


“Hello, world" would become "Kfool/Ztlgog": 


Listing 9.1: Python 


#!/usr/bin/python 
msg="Hello, world!" 


print "".join(map(lambda x: chr(ord(x)^3), msg) ) 


This is quite interesting encryption (or rather obfuscation), because it has two im- 
portant properties: 1) single function for encryption/decryption, just apply it again; 
2) resulting characters are also printable, so the whole string can be used in source 
code without escaping characters. 


The second property exploits the fact that all printable characters organized in rows: 
0x2x-0x7x, and when you flip two lowest bits, character moving 1 or 3 characters 
left or right, but never moved to another (maybe non-printable) row: 
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Figure 9.1: 7-bit ASCII table in Emacs 


...With a single exception of Ox7F character. 


For example, let's encrypt characters in A-Z range: 


#!/usr/bin/python 
msg="@ABCDEFGHIJKLMNO" 


print "".join(map(lambda x: chr(ord(x)^3), msg) ) 


Result: CBA@GFEDKJ IHONML. 
It’s like “@” and “C” characters has been swapped, and so are “B” and “a”. 


Yet again, this is interesting example of exploiting XOR properties, rather than en- 
cryption: the very same effect of preserving printableness can be achieved while 
flipping any of lowest 4 bits, in any combination. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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9.1.2 Norton Guide: simplest possible 1-byte XOR encryption 


Norton Guide was popular in the epoch of MS-DOS, it was a resident program that 
worked as a hypertext reference manual. 


Norton Guide's databases are files with the extension .ng, the contents of which look 
encrypted: 


view X86.NG - Far 2.0.1807 x64 Administrator 


0000000170: 
0000000180: 
0000000190: 
00000001A0: 
00000001B0: 
00000001C0: 
00000001D0: 
00000001E0: 
00000001F0: 
0000000200: 
0000000210: 
0000000220: 
0000000230: 
0000000240: 
0000000250: 
0000000260: 
0000000270: 
0000000280: 
0000000290: 
00000002A0: 
00000002B0: 
00000002C0: 
00000002D0: 
00000002E0: 
00000002F0: 
0000000300: 
0000000310: 
0000000320: 


t> | + 
MO e + e + + 
>=> 12214 towet> 
iwidkiSUbisN 
———— t 
d 
Y JO»Stinhoyn 
sut: ian-Ho}sinoh 
i-Jhunaynsut6: jh 
s1svaja>_byajnsu 
ti>[““hoiist):wu 
~Oi-Ujyu~oi-t-Q 
>> 3 3 
>>>! ni-illnA» 
——————— op 
+>>>>>1J0>Stinh 
oynsut:ian>Ha)si 
nohi6:~{n{:ncjoi 
2133-7 > 
[SP 
WWB=Stinhoynsut: 
ian>-Ilollb>>xxx 
pa? Ga 3 3 3 
1K9>>. Lb8ML be> 
»cir:29[19»à1^ 
32531a07^31g (^51 


Figure 9.2: Very typical look 


Why did we think that it's encrypted but not compressed? 


We see that the 0x1A byte (looking like "—") occurs often, it would not be possible 
in a compressed file. 


We also see long parts that consist only of Latin letters, and they look like strings in 
an unknown language. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: 
s. Thanks! 
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Since the Ox1A byte occurs so often, we can try to decrypt the file, assuming that 
it's encrypted by the simplest XOR-encryption. 


If we apply XOR with the Ox1A constant to each byte in Hiew, we can see familiar 
English text strings: 


X86.NG BFUO EDITMODE 0000032F 
00000170: 02 00-A9 00 Bl B 
00000180: 00 00-00 00 B 
00000190: 02 00-F3 E8 xB +n 
000001A0: 03 00-54 00 smBl rq OAR 
000001B0: 080 00-6E 00 d 
000001C0: o8 00-8F 00 A 
000001D0: 00 00-AS8 00 E M 
000001E0: 73 74-72 75 CPU Instruct 
000001F0: 67 69-73 74 ion set Register 
00000200: 6F 6E-2C 20 s Protection, pr 
00000210: 63 65-70 74 ivilege Exceptio 
00000220: 69 6E-67 20 ns Addressing mo 
00000230: 73 00-00 02 des Opcodes BK 
00000240: oe 00-00 08 a gl 
00000250: 00 83-B2 04 8 ria $ 
00000260: og 00-08 08 4 J 
00000270: 00 49-6E 73 FPU Instr 
00000280: 00 52-65 67 uction set Regis 
00000290: 20 74-79 70 ters, data types 
000002A0: 00 00-00 00 a) AD 
000002B0: @@ 00-B6 DC 
000002C0: oo 00-00 00 B 
000002D0: 63 74-69 6F MMX Instruction 
000002E0: 00 00-00 FF set car 
000002F0: oe 00-00 00 
00000300: 00 57-03 D6 APA 48x8 Wye 
00000310: 24 00-00 B3 
00000320: 03 7D-32 00 

|& Eword ZiQuord E | — 


Figure 9.3: Hiew XORing with Ox1A 


XOR encryption with one single constant byte is the simplest possible encryption 
method, which is, nevertheless, encountered sometimes. 


Now we understand why the Ox1A byte is occurring so often: because there are so 
many zero bytes and they were replaced by Ox1A in encrypted form. 


But the constant might be different. In this case, we could try every constant in the 
0..255 range and look for something familiar in the decrypted file. 256 is not so 
much. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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More about Norton Guide's file format: http://www.davep.org/norton-guides/ 
file-format/. 


Entropy 


A very important property of such primitive encryption systems is that the informa- 
tion entropy of the encrypted/decrypted block is the same. 


Here is my analysis in Wolfram Mathematica 10. 


Listing 9.2: Wolfram Mathematica 10 


In[1]:= input = BinaryReadList["X86.NG"]; 
In[2]:= Entropy[2, input] // N 
Out[2]= 5.62724 


In[3]:= decrypted = Map[BitXor[#, 16^^1A] &, input]; 
In[4]:= Export["X86 decrypted.NG", decrypted, "Binary"]; 


In[5]: 
Out [5] 


Entropy[2, decrypted] // N 
5.62724 


In[6]:= Entropy[2, ExampleData[{"Text", "ShakespearesSonnets"}]] // N 
Out[6]= 4.42366 


What we do here is load the file, get its entropy, decrypt it, save it and get the 
entropy again (the same!). 


Mathematica also offers some well-known English language texts for analysis. 


So we also get the entropy of Shakespeare’s sonnets, and it is close to the entropy 
of the file we just analyzed. 


The file we analyzed consists of English language sentences, which are close to the 
language of Shakespeare. 


And the XOR-ed bitwise English language text has the same entropy. 
However, this is not true when the file is XOR-ed with a pattern larger than one byte. 


The file we analyzed can be downloaded here: http://beginners.re/examples/ 
norton guide/X86.NG. 


One more word about base of entropy 


Wolfram Mathematica calculates entropy with base of e (base of the natural loga- 
rithm), and the UNIX ent utility! uses base 2. 


So we set base 2 explicitly in Entropy command, so Mathematica will give us the 
same results as the ent utility. 


lhttp://www.fourmilab.ch/random/ 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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9.1.3 Simplest possible 4-byte XOR encryption 


If a longer pattern was used for XOR-encryption, for example a 4 byte pattern, it's 
easy to spot as well. 


For example, here is the beginning of the kernel32.dll file (32-bit version from Win- 
dows Server 2008): 


Figure 9.4: Original file 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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Here it is "encrypted" with a 4-byte key: 


ernel32.dll.encrypted 


2. d 


Figure 9.5: “Encrypted” file 


It's very easy to spot the recurring 4 symbols. 


Indeed, the header of a PE-file has a lot of long zero areas, which are the reason for 
the key to become visible. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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Here is the beginning of a PE-header in hexadecimal form: 


C:\tmp2\kernel32.d11 PE .7DD60290 
. 70D600E0: 00-00 
. 7DD600F0: 53-00 
. 70060100: 20-00 
. 70060110: 00-00 
. 70060120: 00-00 
. 70060130: 00-00 
. 70060140: 00-03 
. 70060150: 00-00 
.70D60160: 00-B1 
.70D60170: 00-28 
.70D60180: 00-00 
. 70060190: 00-38 
. 7DD601A0: 00-00 
. 7DD601B0 : 00-40 
. 7DD601C0 : 00-FO 
.70D601D0: 00-00 
. 7DD601E0: 78-74 
. 7DD601F0: 00-00 
. 70060200: 00-20 
. 70D60210: 00-00 
. 70060220: 00-00 
. 7DD60230: 72-63 
. 70D60240: 00-00 
. 70D60250: 00-40 
. 7D60260: 00-00 
. 70060270: 00-00 
.70D60280: 20-20 
.7DD60290: [E 00-00 
Globa E E 


Figure 9.6: PE-header 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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Here it is "encrypted": 


Hiew: kernel32.dll.encrypted 


00000290 
000000E0: 61 D2 63-8C cMaycg $c [ 
eeoooore: FB C7 30-8C Bv }OMaycMaycla4B 
00000100: 60 DB 63-8C 3" fema cMazcMayc 
00000110: 53 D3 63-8C Bs. cMalLcMal Mags 
00000120: 61 D3 63-8C MalcMalckalckale 
00000130: 61 D3 63-8C KallcMaycMa hcMalc 
00000140: 64 C3 63-8F "d|cflaTbMa pcMqyc 
00000150: 61 C2 63-8C MaycMqycMaycbarc 
00000160: 9E D9 63-3D rol c- Ercut cx qe 
00000170: 61 DD 63-A4 Ma] cadycMaycMayc 
00000180: 61 D2 63-80 MaycMaycMayc8lbyc 
00000190: 66 DF 63-B4 ae pd 
000001A0: 61 D2 63-8C MagcMagcMagcMagc 


000001B0: 54 DA 63-CC bT rc feycHoycHagc 


000001C0: 61 D3 63-7C Malc|1ycMaycMayc 
000001D0: 61 D2 63-8C MagycMagcMa Hare 
000001E0: 15 B7 1B-F8 By Ba cer Jena c 
000001F0: 61 DF 63-8C MalicMa  cMa, c Magic 
00000200: 61 D2 63-AC MagcharBeB| Barc 
00000210: 71 D2 63-8C AqycMagcMa cMagc 
00000220: 61 D2 63-8C MagcMagcMagc karr 
00000230: 13 A1 11-EF BBlóBlaa citu 
00000240: 61 D3 63-8C MalcMa] cMaycMayc 
00000250: 61 D2 63-CC Marc faten Byrce 
00000260: CC D2 63-8C al cMarcMalcMarc 
00000270: 61 D2 63-8C MaycMaycMarc baz! 
00000280: 61 D2 63-8C MagcMagcMagcMagc 
00000290: [f$ 61 D2 63-80 [[arcMaycMagcMarc 
1819581 2F1181k 3CryBik 4:307 : KistrindEDirecd Table PE 10leave 11 


Figure 9.7: "Encrypted" PE-header 


It’s easy to spot that the key is the following 4 bytes: 8C 61 D2 63. 
With this information, it's easy to decrypt the whole file. 


So itis important to keep in mind these properties of PE-files: 1) PE-header has many 
zero-filled areas; 2) all PE-sections are padded with zeros at a page boundary (4096 
bytes), so long zero areas are usually present after each section. 


Some other file formats may contain long zero areas. 
It's typical for files used by scientific and engineering software. 


For those who want to inspect these files on their own, they are downloadable here: 
http://beginners.re/examples/XOR 4byte/. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Exercise 


* http://challenges.re/50 


9.1.4 Simple encryption using XOR mask 


l've found an old interactive fiction game while diving deep into if-archive?: 


The New Castle v3.5 - Text/Adventure Game 

in the style of the original Infocom (tm) 

type games, Zork, Collosal Cave (Adventure), 

etc. Can you solve the mystery of the 

abandoned castle? 

Shareware from Software Customization. 

Software Customization [ASP] Version 3.5 Feb. 2000 


It's downloadable here: https://beginners.re/paywall/REAB- source/current-tree/ 
/ff/XOR/mask 1/files/newcastle.tgz. 


There is a file inside (named castle.dbf) which is clearly encrypted, but not by a real 
crypto algorithm, nor it's compressed, this is something rather simpler. | wouldn't 
even measure entropy level (9.2 on page 1195) of the file, because I’m sure it's low. 
Here is how it looks like in Midnight Commander: 


uqa 
uP: Jig Ao Rim: a 
.hu.m.j a 
.uECTu a 
3 .hu.m.j a 
j. hu. m. 


E: od. 1ubge. Z. rn. FE z.uPg.tq 


, .hu.m. 


E BS os EUER | 


Figure 9.8: Encrypted file in Midnight Commander 


The encrypted file can be downloaded here: https://beginners.re/paywall/REAB- source/ 
current-tree//ff/XOR/mask 1/files/castle.dbf.bz2. 


?http://www.ifarchive.org/ 
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Will it be possible to decrypt it without accessing to the program, using just this file? 


There is a clearly visible pattern of repeating string. If a simple encryption by XOR 
mask was applied, such repeating strings is a prominent signature, because, prob- 
ably, there were a long lacunas? of zero bytes, which, in turn, are present in many 
executable files as well as in binary data files. 


Here I'll dump the file's beginning using xxd UNIX utility: 


0000030: 09 61 Od 63 Of 77 14 69 75 62 67 76 01 7e 1d 61 .a.c.w.iubgv.-.a 
0000040: 7a 11 Of 72 6e 03 05 7d 7d 63 7e 77 66 le 7a 02 z..rn..))c-wf.z. 
0000050: 75 50 02 4a 31 71 31 33 5c 27 08 5c 51 74 3e 39 uP.J1q13X' .10t>9 
0000060: 50 2e 28 72 24 4b 38 21 4c 09 37 38 3b 51 41 2d P.(r$K8!L.78;QA- 
0000070: 1c 3c 37 5d 27 5a 1c 7c 6a 10 14 68 77 08 6d la .«7]'Z.|j..hw.m. 


0000080: 6a 09 61 Od 63 Of 77 14 69 75 62 67 76 01 7e 1d j.a.c.w.iubgv.~. 
0000090: 61 7a 11 Of 72 6e 03 05 7d 7d 63 7e 77 66 le 7a az..rn..}}c~wFf.z 
0000020: 02 75 50 64 02 74 71 66 76 19 63 08 13 17 74 7d .uPd.tqfv.c...t) 
00000b0: 6b 19 63 6d 72 66 0e 79 73 1f 09 75 71 6f 05 04 k.cmrf.ys..uqo.. 
00000c0: 7f 1c 7a 65 08 6e Oe 12 7c 6a 10 14 68 77 08 6d ..ze.n..|j..hw.m 


00000d0: la 6a 09 61 Od 63 Of 77 14 69 75 62 67 76 01 7e .j.a.c.w.iubgv.- 
00000€e0: 1d 61 7a 11 Of 72 6e 03 05 7d 7d 63 7e 77 66 le .az..rn..))c-wf. 
00000f0: 7a 02 75 50 01 4a 3b 71 2d 38 56 34 5b 13 40 3c z.uP.J;q-8V4[.@< 
0000100: 3c 3f 19 26 3b 3b 2a Oe 35 26 4d 42 26 71 26 4b <?.&;;*. 58&MB&q&K 
0000110: 04 2b 54 3f 65 40 2b 4f 40 28 39 10 5b 2e 77 45 .4+T?e@+0@(9.[.WwE 


0000120: 28 54 75 09 61 0d 63 0f 77 14 69 75 62 67 76 01 (Tu.a.c.w.iubgv. 
0000130: 7e 1d 61 7a 11 Of 72 6e 03 05 7d 7d 63 7e 77 66 -.az..rn..)) c-wf 
0000140: le 7a 02 75 50 02 4a 31 71 15 3e 58 27 47 44 17 .z.uP.J1q.»X'GD. 
0000150: 3f 33 24 4e 30 6c 72 66 Oe 79 73 1f 09 75 71 6f ?3$NOlrf.ys..uqo 
0000160: 05 04 7f 1c 7a 65 08 Ge Oe 12 7c 6a 10 14 68 77 ....ze.n..|j..hw 


Let's stick at visible repeating iubgv string. By looking at this dump, we can clearly 
see that the period of the string occurrence is 0x51 or 81. Probably, 81 is size of 
block? The size of the file is 1658961, and it can be divided evenly by 81 (and there 
are 20481 blocks then). 


Now I'll use Mathematica to analyze, are there repeating 81-byte blocks in the file? 
I’ll split input file by 81-byte blocks and then I'll use Ta/ly[]^ function which just counts, 
how many times some item has been occurred in the input list. Tally's output is not 
sorted, so | also add Sort[] function to sort it by number of occurrences in descending 
order. 


input = BinaryReadList["/home/dennis/.../castle.dbf"]; 


blocks = Partition[input, 81]; 


3As in https://en.wikipedia.org/wiki/Lacuna_(manuscripts) 
4https://reference.wolfram.com/language/ref/Tally. html 
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stat = Sort[Tally[blocks], #1[[2]] > #2[[2]] &] 


And here is output: 


{{{80, 103, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, 125, 107, 
25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 111, 5, 4, 
127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 104, 119, 8, 
109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, 
1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 
119, 102, 30, 122, 2, 117}, 1739}, 

{{80, 100, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, 

125, 107, 25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 
111, 5, 4, 127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 
104, 119, 8, 109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 
98, 103, 118, 1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 
125, 99, 126, 119, 102, 30, 122, 2, 117}, 1422}, 

{{80, 101, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, 

125, 107, 25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 
111, 5, 4, 127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 
104, 119, 8, 109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 
98, 103, 118, 1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 
125, 99, 126, 119, 102, 30, 122, 2, 117}, 1012}, 

{{80, 120, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, 

125, 107, 25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 
111, 5, 4, 127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 
104, 119, 8, 109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 
98, 103, 118, 1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 
125, 99, 126, 119, 102, 30, 122, 2, 117}, 377}, 


{{80, 2, 74, 49, 113, 21, 62, 88, 39, 71, 68, 23, 63, 51, 36, 78, 48, 
108, 114, 102, 14, 121, 115, 31, 9, 117, 113, 111, 5, 4, 127, 28, 
122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 104, 119, 8, 109, 26, 
106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, 1, 126, 
29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, 102, 
30, 122, 2, 117}, 1}, 

{{80, 1, 74, 59, 113, 45, 56, 86, 52, 91, 19, 64, 60, 60, 63, 

25, 38, 59, 59, 42, 14, 53, 38, 77, 66, 38, 113, 38, 75, 4, 43, 84, 
63, 101, 64, 43, 79, 64, 40, 57, 16, 91, 46, 119, 69, 40, 84, 117, 
9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, 1, 126, 29, 

97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, 102, 30, 

122, 2, 117}, 1}, 

{{80, 2, 74, 49, 113, 49, 51, 92, 39, 8, 92, 81, 116, 62, 57, 

80, 46, 40, 114, 36, 75, 56, 33, 76, 9, 55, 56, 59, 81, 65, 45, 28, 
60, 55, 93, 39, 90, 28, 124, 106, 16, 20, 104, 119, 8, 109, 26, 

106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, 1, 126, 

29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, 102, 

30, 122, 2, 117}, 1}} 


Tally’s output is a list of pairs, each pair has 81-byte block and number of times it 
has been occurred in the file. We see that the most frequent block is the first, it has 
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been occurred 1739 times. The second one has been occurred 1422 times. There 
are others: 1012 times, 377 times, etc. 81-byte blocks which has been occurred just 
once are at the end of output. 


Let's try to compare these blocks. The first and the second. Is there a function 
in Mathematica which compares lists/arrays? Certainly is, but for educational pur- 
poses, I'll use XOR operation for comparison. Indeed: if bytes in two input arrays are 
identical, XOR result is O. If they are non-equal, result will be non-zero. 


Let's compare first block (occurred 1739 times) and the second (occurred 1422 
times): 


In[]:= BitXor[stat[[1]][[1]], stat[[211[[1111 

Out[]= (0, 3, 0, 0, 0, 0, 0, 0, 0,0, 0,0, 0, 0, 0, 0, 0, 0, O, \ 

0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, ©, 0, 0, ©, ©, ©, 0, 00, 0, 0, \ 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, ©, 0, 0, ©, 0, ©, 0, ©, 0, 0, \ 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, O, OF 


They are differ only in the second byte. 


Let’s compare the second block (occurred 1422 times) and the third (occurred 1012 
times): 


In[]:= BitXor[stat[[2]][[1]], stat[I[311[[111] 

Out[]= (0, 1, 0, 0, 0, 0, 0,0, 0,0, 0, 0, 0,0, 0, 0, 0, 0, 0, \ 

0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, \ 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, \ 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, O, 0, 0, 0) 


They are also differ only in the second byte. 


Anyway, let’s try to use the most occurred block as a XOR key and try to decrypt 
four first 81-byte blocks in the file: 


In[]:= key = stat[[1]][[1]] 
Out[]2» {80, 103, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, \ 


125, 107, 25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 111, \ 
5, 4, 127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 104, 119, \ 
8, 109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, \ 
1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, \ 
102, 30, 122, 2, 117) 
In[]:= ToASCII[val ] := If[val == 0, " ", FromCharacterCode[val, "2 

4 PrintableASCII"]] 
In[]:= DecryptBlockASCII[blk ] := Map[ToASCII[#] &, BitXor[key, blk]] 
In[]:= DecryptBlockASCII[blocks[[1]]] 
Outlet t uo ge ge a RE SUIS ey gt RE S HR PUR AN 
wy noH Ho nons Hows nons wow, nons wow, nons wow, nons wow, nons wow 
wy ons woa nons uH us nons wow, nons wow, nons wow, nons wow, nons now 
"onou Hon, nons How, nons won, nons wow, nons wow, nons wow, nons nov 
"onou Won, nons Hou, nons wow, nons wow, nons wow, nons wow, nons nov 
u A u n : u n P n u 7 n u , u n , u n A LLI u P n u , u n A u n ; u n ; n u i u "} 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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DecryptBlockASCII[blocks[[2]]] 

{" | "H", SE S E TUR "Ww", “Eg i ar "Dis i E "0% N 

E a " m "C, "R", "bs "M", gir b t "B", ES, WAS "R", nge " ar \ 
BA ATA, "ES ARA A ra AB AR UL "T9 5$, N 


, 
"n ou "n ou "n ou "n onu "nonu "nou nou "n onu "nonu "n ou "n ou "n nu n nu "n ou N 
D D , , , D , , D D , , D D 
n nu n nu n nu "n onu "n nu n nu n nu "n n "n onu n nu n nu "n onu "n nu n nu N 
D , , , , , , , , , , , , , 
n nu n nu n nu "nonu "n n n nu n nu "n nu "n nu "n nu n nu "n onu "nonu n nu N 
D D D D , , , , , , , , , , 


In[]:= up Cu NP RIPE 
Out[]= {" pb "ons nons non, nons nox 


D , , D , , D D 

" "n onu "n nu n nu n nu "n nu "n nu n nu n nu "n onu "n nu n nu n nu n nu " 

, , , , , , , , , , , , , , N 
" "n nu "n onu n nu nonu "n onu "n onu n nu n nu "n on "n on n nu n nu "n onu " 

, , , , , , , , , , , , , , N 
n" "n onu "n nu n nu n nu "n n "nonu n nu n nu "n n "n nu n nu n nu "n onu " 

, , , , , , , , , , , , , , N 
" "n onu "n onu "n ou "n ou "n nu "n onu nou nou "nonu "nonu "nou "n ou "n nu n 

, , , , , , , D , , D D , , N 
" "n nu n nu "n ou "n ou "n onu "n nu "n ou "nou "nonu "n onu "n ou "n ou "nonu n 

, , , , , , D D , , D D , , N 
") 


DecryptBlockASCII[blocks[[411] 
{" M i in "HU, "o", LLI ur "K", "NU, "o", "Ww", "S LLI a \ 
"y" P "H" ; "A", "T", LLI LLI "E, "yn, LLI I LLI ; LLI EL i LLI LLI j LLI | i a Ia i LLI R" , "kK" 7 \ 


"St coy UU, Ny Tous Hoy A "ES AS, RE, OTT N 
"Sra s Eu SU Er ru Mex. NUR EIUS S SE n WR D UAE RS 

won) nons non, now, nons now, nons wo ms now, n wo How Won,» now, wow, YN 
won) nons non, now, nons now, non, Ho ws "ouo n wo How Won, n wo wow, YN 


"oj 


(l've replaced unprintable characters by "?".) 


So we see that the first and the third blocks are empty (or almost empty), but the 
second and the fourth has clearly visible English language words/phrases. It seems 
that our assumption about key is correct (at least partially). This means that the 
most occurred 81-byte block in the file can be found at places of lacunas of zero 
bytes or something like that. 


Let's try to decrypt the whole file: 


DecryptBlock[blk ] := BitXor[key, blk] 
decrypted = Map[DecryptBlock[#] &, blocks]; 
BinaryWrite["/home/dennis/.../tmp", Flatten[decrypted] ] 


Close["/home/dennis/.../tmp"] 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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3*E-book/decrupt dat file/tmp 4811/1628K B 


Figure 9.9: Decrypted file in Midnight Commander, 1st attempt 


Looks like some kind of English phrases from some game, but something wrong. 
First of all, cases are inverted: phrases and some words are started with lowercase 
characters, while other characters are in upper case. Also, some phrases started 
with wrong letters. Take a look at the very first phrase: “eHE WEED OF CRIME BEARS 
BITTER FRUIT". What is "eHE"? Isn't “tHE” have to be here? Is it possible that our 
decryption key has wrong byte at this place? 


Let's look again at the second block in the file, at key and at decryption result: 


In[]:= blocks[[2]] 

Out[]= (80, 2, 74, 49, 113, 49, 51, 92, 39, 8, 92, 81, 116, 62, \ 

57, 80, 46, 40, 114, 36, 75, 56, 33, 76, 9, 55, 56, 59, 81, 65, 45, \ 
28, 60, 55, 93, 39, 90, 28, 124, 106, 16, 20, 104, 119, 8, 109, 26, \ 
106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, 1, 126, 29, \ 
97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, 102, 30, \ 
122, 2, 117} 


In[]:= key 

Out[]= (80, 103, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, \ 

125, 107, 25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 111, \ 
5, 4, 127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 104, 119, \ 
8, 109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, \ 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: 
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1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, \ 
102, 30, 122, 2, 117} 


In[]:= BitXor[key, blocks[[2]]] 

Out[]= (0, 101, 72, 69, O, 87, 69, 69, 68, O, 79, 70, 0, 67, 82, \ 
73, 77, 69, 0, 66, 69, 65, 82, 83, 0, 66, 73, 84, 84, 69, 82, 0, 70, \ 
82, 85, 73, 84, 14, 0, 0, 0, 06,0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, O, \ 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, \ 
0, 0, 0, 0) 


Encrypted byte is 2, the byte from the key is 103, 26103 = 101 and 101 is ASCII code 
for “e” character. What byte of a key must be equal to, so the resulting ASCII code 
will i 116 (for "t" character)? 26116 = 118, let's put 118 in key at the second byte 


key = (80, 118, 2, 116, 113, 102, 118, 25, 99, 8, 19, 23, 116, 125, 
107, 25, 99, 109, 114, 102, 14, 121, 115, 31, 9, 117, 113, 111, 5, 
4, 127, 28, 122, 101, 8, 110, 14, 18, 124, 106, 16, 20, 104, 119, 8, 

109, 26, 106, 9, 97, 13, 99, 15, 119, 20, 105, 117, 98, 103, 118, 
1, 126, 29, 97, 122, 17, 15, 114, 110, 3, 5, 125, 125, 99, 126, 119, 
102, 30, 122, 2, 117} 


...and decrypt the whole file again. 


tHE. WEED. OF 


RND. NOT. absolute...... 


voe LEER SES DB oss uice exit x eO C 


0. 15. RUNNING. HEAD 
FIRST. INTO. BRICK: WALLS.. 


LEY LETTERED. SIGN. READING Sana tss MORS ya : VAS RCRUS GUB UV UR A an a eee oes oT 


Figure 9.10: Decrypted file in Midnight Commander, 2nd attempt 


Wow, now the grammar is correct, all phrases started with correct letters. But still, 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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case inversion is suspicious. Why would game's developer write them in such a 
manner? Maybe our key is still incorrect? 


While observing ASCII table we can notice that uppercase and lowercase letter's 
ASCII codes are differ in just one bit (6th bit starting at 1st, 06100000): 


Figure 9.11: 7-bit ASCII table in Emacs 


6th bit set in a zero byte has decimal form of 32. But 32 is ASCII code for space! 


Indeed, one can switch case just by XOR-ing ASCII character code with 32 (more 
about it: 3.19.3 on page 674). 


It is possible that the empty lacunas in the file are not zero bytes, but rather spaces? 
Let's modify XOR key one more time (I'll XOR each byte of key by 32): 


(* "32" is scalar and "key" is vector, but that's OK *) 


In[]:= key3 = BitXor[32, key] 

Out[]= (112, 86, 34, 84, 81, 70, 86, 57, 67, 40, 51, 55, 84, 93, 75, \ 
57, 67, 77, 82, 70, 46, 89, 83, 63, 41, 85, 81, 79, 37, 36, 95, 60, \ 
90, 69, 40, 78, 46, 50, 92, 74, 48, 52, 72, 87, 40, 77, 58, 74, 41, \ 
65, 45, 67, 47, 87, 52, 73, 85, 66, 71, 86, 33, 94, 61, 65, 90, 49, \ 
47, 82, 78, 35, 37, 93, 93, 67, 94, 87, 70, 62, 90, 34, 85} 


In[]:= DecryptBlock[blk_] := BitXor[key3, blk] 


Let’s decrypt the input file again: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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/ home/dennis/P/RE-book/decrupt dat file/tmp3 


Figure 9.12: Decrypted file in Midnight Commander, final attempt 


(Decrypted file is available here: 


2 


This is undoubtedly a correct source file. Oh, and we see numbers at the start of each 
block. It has to be a source of our erroneous XOR key. As it seems, the most occurred 
81-byte block in the file is a block filled with spaces and containing "1" character 
at the place of second byte. Indeed, somehow, many blocks here are interleaved 
with this one. Maybe it's some kind of padding for short phrases/messages? Other 
frequently occurred 81-byte blocks are also space-filled blocks, but with different 
digit, hence, they are differ only at the second byte. 


That's all! Now we can write an utility to encrypt the file back, and maybe modify it 
before. 


Mathematica notebook file is downloadable here: 


Summary: XOR encryption like that is not robust at all. It has been intended by 
game's developer(s), probably, just to prevent gamer(s) to peek into internals of 
game, nothing else more serious. Still, encryption like that is extremely popular due 
to its simplicity and many reverse engineers are usually familiar with it. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: 
. Thanks! 
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9.1.5 Simple encryption using XOR mask, case Il 


l've got another encrypted file, which is clearly encrypted by something simple, like 
XOR-ing: 


fhome/dennis/tmp/cipher, txt Bx«aaaannnaa 
MBBBBBBa y 
46088018 
46888628 
46600638 
4a888848 
46680858 
VBBBAB6A 
46088078 
VBBBABEa 
VBBBAB9A 
VBBBABAD 
VBBBBBBA 
VBBBBBCO 
VBBBABDA 
PBBBABEA 
DBBBABFa 
46666168 
46060110 
46060120 
46060138 
46460148 
46060156 
46080168 
446001 78 
46080188 
46080198 
460801AB 
VBBBB1BA 
46080108 
VBBBB1DA 
VBBBB1EO 
460001F 8 


Figure 9.13: Encrypted file in Midnight Commander 


The encrypted file can be downloaded 


ent Linux utility reports about ~7.5 bits per byte, and this is high level of entropy 
( ), close to compressed or properly encrypted file. But still, we 
clearly see some pattern, there are some blocks with size of 17 bytes, and you can 
see some kind of ladder, shifting by 1 byte at each 16-byte line. 


It’s also known that the plain text is just English language text. 


Now let’s assume that this piece of text is encrypted by simple XOR-ing with 17-byte 
key. 


| tried to find some repeating 17-byte blocks using Mathematica, like | did before in 
my previous example ( ): 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: 
. Thanks! 
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Listing 9.3: Mathematica 


In[]:=input = BinaryReadList["/home/dennis/tmp/cipher.txt"]; 
In[]:=blocks = Partition[input, 17]; 
In[]:=Sort[Tally[blocks], #1[[2]] > #2[[2]] &] 


Out[] :={{{248,128,88,63,58,175,159, 154, 232, 226,161,50,97,127,3,217,80},1}, 
{{226,207,67,60,42, 226,219,150, 246, 163,166,56,97,101,18,144,82},1}, 
{{228,128,79,49,59, 250,137,154, 165, 236,169, 118,53,122,31,217,65},1}, 
{{252,217,1,39, 39,238,143, 223,241,235,170,91,75,119,2,152,82},1}, 
{{244,204,88,112,59,234,151,147,165,238,170,118,49,126,27,144,95},1}, 
{{241,196,78,112,54,224,142,223,242,236,186,58,37,50,17,144,95},1}, 
{{176,201,71,112,56,230,143,151,234,246,187,118,44,125,8,156,17},1}, 


{{255,206,82,112,56,231,158,145,165,235,170,118,54,115,9,217,68},1}, 
{{249,206,71,34,42,254,142,154, 235, 247,239,57,34,113,27,138,88},1}, 
{{157,170,84,32,32,225,219, 139, 237, 236,188,51,97,124,21,141,17},1}, 
{{248,197,1,61,32,253,149,150,235,228,188,122,97,97,27,143,84},1}, 

{{252,217,1,38,42,253,130,223,233,226,187,51,97,123,20,217,69},1}, 

{{245,211,13,112,56,231,148,223,242,226,188,118,52,97,15,152,93},1}, 
{{221,210,15,112, 28, 231,158,141, 233,236,172,61,97,90,21,149,92},1}} 


No luck, each 17-byte block is unique within the file and occurred only once. Perhaps, 
there are no 17-byte zero lacunas, or lacunas containing only spaces. It is possible 
indeed: such long space indentation and padding may be absent in tightly typeset 
text. 


The first idea is to try all possible 17-byte keys and find those, which will result in 
readable text after decryption. Bruteforce is not an option, because there are 256!” 
possible keys (~10*°), that's too much. But there are good news: who said we have 
to test 17-byte key as a whole, why can’t we test each byte of key separately? It is 
possible indeed. 


Now the algorithm is: 
* try all 256 bytes for 1st byte of key; 
* decrypt 1st byte of each 17-byte blocks in the file; 
* are all decrypted bytes we got are printable? keep tabs on it; 
* do so for all 17 bytes of key. 


l've written the following Python script to check this idea: 


Listing 9.4: Python script 


each Nth byte-[""]*KEY LEN 


content-read file(sys.argv[1]) 
# split input by 17-byte chunks: 
all_chunks=chunks (content, KEY LEN) 
for c in all chunks: 

for i in range(KEY LEN): 
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each Nth_byte[i]=each Nth byte[i] + c[il 


# try each byte of key 
for N in range(KEY LEN): 
print "N=", N 
possible keys=[] 
for i in range(256): 
tmp keyschr(i)*len(each Nth byte[N]) 
tmp-xor strings(tmp key,each Nth byte[N]) 
# are all characters in tmp[] are printable? 
if is string printable(tmp)--False: 
continue 
possible keys.append(i) 
print possible keys, "len=", len(possible keys) 


(Full version of the source code is here.) 


Here is its output: 


N- 0 

[144, 145, 151] len= 3 
N= 1 

[160, 161] len= 2 
N= 2 

[32, 33, 38] len= 3 
N= 3 

[80, 81, 87] len= 3 
N= 4 

[78, 79] len= 2 

N= 5 

[142, 143] len= 2 
N= 6 

[250, 251] len= 2 
N= 7 

[254, 255] len= 2 
N= 8 

[130, 132, 133] len= 3 
N= 9 

[130, 131] len= 2 
N= 10 

[206, 207] len= 2 
N= 11 

[81, 86, 87] len= 3 
N= 12 

[64, 65] len= 2 

N= 13 

[18, 19] len= 2 

N= 14 

[122, 123] len= 2 
N= 15 

[248, 249] len= 2 
N= 16 


[48, 49] len= 2 
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So there are 2 or 3 possible bytes for each byte of 17-byte key. This is much better 
than 256 possible bytes for each byte, but still too much. There are up to 1 million 
of possible keys: 


Listing 9.5: Mathematica 


In[]: 
Out [] 


3*2*3*3*2*2¥*2*2*3*2*2*3*2*2*2*2*2 
995328 


It’s possible to check all of them, but then we must check visually, if the decrypted 
text is looks like English language text. 


Let's also take into consideration the fact that we deal with 1) natural language; 
2) English language. Natural languages has some prominent statistical features. 
First of all, punctuation and word lengths. What is average word length in English 
language? Let's just count spaces in some well-known English language texts using 
Mathematica. 


Here is "The Complete Works of William Shakespeare" text file from Gutenberg Li- 
brary: 


Listing 9.6: Mathematica 


In[]:= input = BinaryReadList["/home/dennis/tmp/pg100.txt"]; 
In[]:= Tally[input] 
Out[]= {{239, 1), (187, 1), (191, 1}, (84, 39878), (104, 


218875), (101, 406157}, (32, 1285884}, (80, 12038}, (114, 

209907), (111, 282560}, (106, 2788), (99, 67194}, (116, 

291243), (71, 11261}, (117, 115225}, (110, 216805}, (98, 

46768}, (103, 57328}, (69, 42703}, (66, 15450}, (107, 29345}, (102, 

69103}, (67, 21526), (109, 95890}, (112, 46849}, (108, 146532], (87, 
16508}, (115, 215605}, (105, 199130}, (97, 245509}, (83, 

34082), (44, 83315}, (121, 85549}, (13, 124787), (10, 124787], 1119, 
73155), (100, 134216}, (118, 34077}, (46, 78216), (89, 9128], (45, 

8150}, (76, 23919}, (42, 73), (79, 33268}, (82, 29040}, 173, 

55893), (72, 18486}, (68, 15726}, (58, 1843}, (65, 44560], (49, 

982}, (50, 373}, (48, 325}, (91, 2076}, (35, 3}, (93, 2068], (74, 

2071), (57, 966}, (52, 107}, (70, 11770}, (85, 14169}, (78, 

27393}, (75, 6206}, (77, 15887}, (120, 4681}, (33, 8840}, (60, 

468), (86, 3587), (51, 343), (88, 608}, (40, 643}, (41, 644), (62, 
440}, (39, 31077}, (34, 488}, (59, 17199}, (126, 1}, (95, 71}, (113, 
2414}, (81, 1179), (63, 10476}, (47, 48}, (55, 45], (54, 73], (64, 
3}, 153, 94}, (56, 47}, (122, 1098}, (90, 532}, (124, 33}, (38, 

21}, (96, 1}, (125, 2}, 137, 1}, (36, 2H 


In[]:= Length[input]/1285884 // N 
Out[]= 4.34712 


There are 1285884 spaces in the whole file, and the frequency of space occurrence 
is 1 space per ~4.3 characters. 


Now here is Alice's Adventures in Wonderland, by Lewis Carroll from the same library: 
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Listing 9.7: Mathematica 


In[]:= input = BinaryReadList["/home/dennis/tmp/pgl11.txt"]; 


In[]:= Tally[input] 

Out[]2» {{239, 1), (187, 1), (191, 1}, (80, 172}, (114, 6398}, (111, 
9243), (106, 222}, (101, 15082}, (99, 2815}, (116, 11629}, (32, 
27964), (71, 193), (117, 3867), (110, 7869}, (98, 1621), (103, 
2750}, (39, 2885}, (115, 6980}, (65, 721), (108, 5053}, (105, 
7802), (100, 5227), (118, 911}, (87, 256}, (97, 9081}, (44, 

2566), (121, 2442}, (76, 158}, (119, 2696}, (67, 185), (13, 

3735), (10, 3735}, (84, 571), (104, 7580}, (66, 125), (107, 

1202), (102, 2248), (109, 2245}, (46, 1206}, (89, 142), (112, 
1796}, (45, 744}, (58, 255}, (68, 242}, (74, 13}, (50, 12}, (53, 
13), (48, 22}, 156, 10}, (91, 4}, (69, 313}, 135, 1}, (49, 68}, (93, 
4), (82, 212}, (77, 222}, (57, 11), (52, 10}, (42, 88}, (83, 

288}, (79, 234}, (70, 134}, (72, 309}, (73, 831}, (85, 111}, (78, 
182), (75, 88), (86, 52}, (51, 13}, (63, 202}, (40, 76}, (41, 

76), (59, 194}, (33, 451}, (113, 135}, (120, 170), (90, 1}, (122, 
79}, (34, 135}, (95, 4}, (81, 85}, (88, 6}, (47, 24}, 155, 6}, (54, 
7), (37, 1}, (64, 2}, (36, 2}} 


In[]:= Length[input]/27964 // N 
Out[]= 5.99049 


The result is different probably because of different formatting of these texts (maybe 
indentation and/or padding). 


OK, so let’s assume the average frequency of space in English language is 1 space 
per 4..7 characters. 


Now the good news again: we can measure frequency of spaces while decrypting our 
file gradually. Now | count spaces in each slice and throw away 1-byte keys which 
produce results with too small number of spaces (or too large, but this is almost 
impossible given so short key): 


Listing 9.8: Python script 


each Nth byte-[""]*KEY LEN 


content-read file(sys.argv[1]) 
# split input by 17-byte chunks: 
all_chunks=chunks (content, KEY LEN) 
for c in all chunks: 
for i in range(KEY LEN): 
each Nth byte[i]zeach Nth byte[i] + c[i] 


# try each byte of key 
for N in range(KEY LEN): 
print "N=", N 
possible keys=[] 
for i in range(256): 
tmp keyschr(i)*len(each Nth byte[N]) 
tmp-xor strings(tmp key,each Nth byte[N]) 
# are all characters in tmp[] are printable? 
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if is string printable(tmp)--False: 
continue 
# count spaces in decrypted buffer: 
spaces-tmp.count(' ') 
if spaces--0: 
continue 
spaces ratio-len(tmp)/spaces 
if spaces ratio«4: 
continue 
if spaces ratio»7: 
continue 
possible keys.append(i) 
print possible keys, "len=", len(possible keys) 


(Full version of the source code is here.) 


This reports just one single possible byte for each byte of key: 


N- 0 

[144] len= 1 
N= 1 

[160] len= 1 
N- 2 

[33] len» 1 

N- 3 

[80] len= 1 

N= 4 

[79] len= 1 

N= 5 

[143] len= 1 
N= 6 

[251] len= 1 
N= 7 

[255] len= 1 
N= 8 

[133] len= 1 
N= 9 

[131] len= 1 
N= 10 

[207] len= 1 
N= 11 

[86] len= 1 

N= 12 

[65] len= 1 

N= 13 

[18] len= 1 

N= 14 

[122] len= 1 
N= 15 

[249] len= 1 
N= 16 

[49] len= 1 


Let’s check this key in Mathematica: 
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Listing 9.9: Mathematica 


In[]:= input = BinaryReadList["/home/dennis/tmp/cipher.txt"]; 


In[]:= blocks = Partition[input, 17]; 


In[]:= key = (144, 160, 33, 80, 79, 143, 251, 255, 133, 131, 207, 86, 65, Y 
S 18, 122, 249, 49}; 


In[]:= EncryptBlock[blk ] := BitXor[key, blk] 


In[]:= encrypted = Map[EncryptBlock[#] &, blocks]; 


In[]:= BinaryWrite["/home/dennis/tmp/plain2.txt", Flatten[encrypted]] 


In[]:= Close["/home/dennis/tmp/plain2.txt"] 


And the plain text is: 


Mr. Sherlock Holmes, who was usually very late in the mornings, save 
upon those not infrequent occasions when he was up all night, was seated 
at the breakfast table. I stood upon the hearth-rug and picked up the 
stick which our visitor had left behind him the night before. It was a 
fine, thick piece of wood, bulbous-headed, of the sort which is known as 
a "Penang lawyer." Just under the head was a broad silver band nearly 

an inch across. "To James Mortimer, M.R.C.S., from his friends of the 
C.C.H.," was engraved upon it, with the date "1884." It was just such a 
stick as the old-fashioned family practitioner used to carry--dignified, 
solid, and reassuring. 


"Well, Watson, what do you make of it?" 


Holmes was sitting with his back to me, and I had given him no sign of 
my occupation. 


(Full version of the text is here.) 


The text looks correct. Yes, | made up this example and choose well-known text of 
Conan Doyle, but it's very close to what | had in my practice some time ago. 


Other ideas to consider 


If we would fail with space counting, there are other ideas to try: 


* Take into consideration the fact that lowercase letters are much more frequent 
than uppercase ones. 


* Frequency analysis. 


* There is also a good technique to detect language of a text: trigrams. Each lan- 
guage has some very frequent letter triplets, these may be "the" and "tha" 
for English. Read more about it: N-Gram-Based Text Categorization, http: 
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//code.activestate.com/recipes/326576/. Interestingly enough, trigrams 
detection can be used when you decrypt a ciphertext gradually, like in this ex- 
ample (you just have to test 3 adjacent decrypted characters). 


For non-Latin writing systems encoded in UTF-8, things may be easier. For ex- 
ample, Russian text encoded in UTF-8 has each byte interleaved with OxDO/OxD1 
byte. It is because Cyrillic characters are placed in 4th block of Unicode table. 
Other writing systems has their own blocks. 


9.1.6 Homework 


An ancient text adventure for MS-DOS, developed in the end of 1980's. To conceal 
game information from player, data files, most likely, XOR-ed with something: https: 
//beginners.re/homework/XOR crypto 1/destiny.zip. Try to get into... 


9.2 Information entropy 


Entropy: The quantitative measure of 
disorder, which in turn relates to the 
thermodynamic functions, temperature, and 
heat. 


Dictionary of Applied Math for Engineers and 
Scientists 


For the sake of simplification, | would say, information entropy is a measure, how 
tightly some piece of data can be compressed. For example, it is usually not pos- 
sible to compress already compressed archive file, so it has high entropy. On the 
other hand, 1MiB of zero bytes can be compressed to a tiny output file. Indeed, in 
plain English language, one million of zeros can be described just as “resulting file 
is one million zero bytes”. Compressed files are usually a list of instructions to de- 
compressor, like this: "put 1000 zeros, then 0x23 byte, then 0x45 byte, then put a 
block of size 10 bytes which we've seen 500 bytes back, etc." 


Texts written in natural languages are also can be compressed tightly, because nat- 
ural languages has a lot of redundancy (otherwise, a tiny typo will always lead to 
misunderstanding, like any toggled bit in compressed archive make decompression 
nearly impossible), some words are used very often, etc. In everyday speech, it's 
possible to drop up to half of words and it still be recognizable. 


Code for CPUs is also can be compressed, because some ISA instructions are used 
much more often than others. In x86, most used instructions are MOV/PUSH/CALL 
(5.11.2 on page 930). 


Data compressors and ciphers tend to produce very high entropy results. Good PRNG 
also produce data which cannot be compressed (it is possible to measure their quality 
by this sign). 


So, in other words, entropy is a measure which can help to probe contents of un- 
known data block. 
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9.2.1 Analyzing entropy in Mathematica 


(This part has been first appeared in my blog at 13-May-2015. Some discussion: 
https://news.ycombinator.com/item?id-9545276.) 


It is possible to slice a file by blocks, calculate entropy of each and draw a graph. I 
did this in Wolfram Mathematica for demonstration and here is a source code (Math- 
ematica 10): 


(* loading the file *) 
input-BinaryReadList["file.bin"]; 


(* setting block sizes *) 
BlockSize=4096;BlockSizeToShow=256; 


(* slice blocks by 4k *) 
blocks=Partition[input,BlockSize]; 


(* how many blocks we've got? *) 
Length[blocks] 


(* calculate entropy for each block. 2 in Entropy[] (base) is set with the 7 
G intention so Entropy[] 

function will produce the same results as Linux ent utility does *) 

entropies=Map[N[Entropy[2,+]]8,blocks]; 


(* helper functions *) 

fBlockToShow[input_,offset_]:=Take[input,(l+offset,1l+offset+BlockSizeToShow 
y ¥] 

fToASCII[val_]:=FromCharacterCode[val,"PrintableASCII"] 

fToHex[val_]:=IntegerString[val,16] 

fPutASCIIWindow[data ]:-Framed[Grid[Partition[Map[fTOASCII,data],16]]] 

fPutHexWindow[data ]:-Framed[Grid[Partition[Map[fToHex, data], 16], ALignment 7 
y ->Right]] 


(* that will be the main knob here *) 
{Slider [Dynamic[offset] ,{0,Length[input] -BlockSize, BlockSize}] ,Dynamic[ 7 
V BaseForm[offset, 16] ]} 


(* main UI part *) 

Dynamic[{ListLinePlot [entropies ,GridLines->{{-1,offset/BlockSize,1}},v 
y Filling->Axis ,AxesLabel->{"offset","entropy"}], 

CurrentBlock=fBlockToShow[input,offset] ; 

fPutHexWindow[CurrentBlock], 

fPutASCIIWindow[CurrentBlock] }] 


GeolP ISP database 


Let's start with the GeolP file (which assigns ISP to the block of IP addresses). This 
binary file GeolPISP.dat has some tables (which are IP address ranges perhaps) plus 
some text blob at the end of the file (containing ISP names). 


When | load it to Mathematica, | see this: 
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In[Bgy;s (* that will be the main knob here x 


(Slider[Dynamic[offset], (0, Length[input] -BlockSize, BlockSize}] 


Ourjesj= | , £70006} 


In[sSy- (+ main UI part + 
Dynamic[(ListLinePlot[entropies, GridLines > ((-1, offset / BlockSiz 
CurrentBlock = fBlockToShow [ input, offset]: 
fPutHexWindow [CurrentBlock] , fPutASCIIWindow [CurrentBlock] }] 


entropy 


Out[59}= 4 


40 


0 200 400 600 800 1000 


I^ P Oo P iP I| 0 IP OPP RP op t 
0000000000000000 
I^ P Ov IP Ov X Ov I9 i a ses 
0000000000000000 
PORRO RRA Rasa 
0000000000000000 
O-0000000230020+<3<0 
BmBoaom«mmouaanmnoadgone«euonuumn 
050'055005500000656500 
0000000000000000 
*Do 00000000 oo4 
Ooovo0000MmMo000r00 
f= = id J Fo em a 05800 
fo e Y rs Fa dm a B= Y | 
00006566000002£000 
DODOONÑNDODoO: + Oir aa 
D000000500050000000 
0000000000000000 
23 05»000> 00 noaoono 
DO> »enuuüuougdgugcdcocoerscgdc 
D000000050050000000 
BD000000000000000 


1 
6 
1 
5 
1 
1 
1 
6 
1 
6 
1 


There are two parts in graph: first is somewhat chaotic, second is more steady. 


0 in vertical axis in graph means lowest entropy (the data which can be compressed 
very tightly, ordered in other words) and 8 is highest (cannot be compressed at all, 
chaotic or random in other words). Why 0 and 8? O means O bits per byte (byte 
as a container is not filled at all) and 8 means 8 bits per byte, i.e., the whole byte 
container is filled with the information tightly. 


So | put slider to point in the middle of the first block, and I clearly see some array of 
32-bit integers. Now | put slider in the middle of the second block and | see English 
text: 
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Inf68];= (+ that will be the main knob here +) 
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Indeed, this are names of ISPs. So, entropy of English text is 4.5-5.5 bits per byte? 
Yes, something like this. Wolfram Mathematica has some well-known English litera- 
ture corpus embedded, and we can see entropy of Shakespeare's sonnets: 


In[]:= Entropy[2,ExampleData[{"Text", "ShakespearesSonnets"}]]//N 
Out[]= 4.42366 


4.4 is close to what we've got (4.7-5.3). Of course, classic English literature texts 
are somewhat different from ISP names and other English texts we can find in binary 
files (debugging/logging/error messages), but this value is close. 
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TP-Link WR941 firmware 


Next example. l've got firmware for TP-Link WR941 router: 


entropy 


We see here 3 blocks with empty lacunas. Then the first block with high entropy 
(started at address 0) is small, second (address somewhere at 0x22000) is bigger 
and third (address 0x123000) is biggest. | can't be sure about exact entropy of the 
first block, but 2nd and 3rd has very high entropy, meaning that these blocks are 
either compressed and/or encrypted. 


| tried binwalk for this firmware file: 


DECIMAL HEXADECIMAL DESCRIPTION 
ky 

0 0x0 TP-Link firmware header, firmware version: 7 
V 0.-15221.3, image version: "", product ID: 0x0, product version: 7 


Y 155254789, kernel load address: 0x0, kernel entry point: Ox-7FFFE000,7 
V kernel offset: 4063744, kernel length: 512, rootfs offset: 837431, 2 
y rootfs length: 1048576, bootloader offset: 2883584, bootloader length» 


V:0 

14832 0x39F0 U-Boot version string, "U-Boot 1.1.4 (Jun 27 2 
2014 - 14:56:49)" 

14880 0x3A20 CRC32 polynomial table, big endian 

16176 0x3F30 ulmage header, header size: 64 bytes, header 2 


V CRC: 0x3AC66E95, created: 2014-06-27 06:56:50, image size: 34587 2 

\ bytes, Data Address: 0x80010000, Entry Point: 0x80010000, data CRC: 07 
\ xDF2DBAOB, OS: Linux, CPU: MIPS, image type: Firmware Image, 7 

y compression type: lzma, image name: "u-boot image" 


16240 Ox3F70 LZMA compressed data, properties: 0x5D, 2 
V dictionary size: 33554432 bytes, uncompressed size: 90000 bytes 
131584 0x20200 TP-Link firmware header, firmware version: 2 
V 0.0.3, image version: "", product ID: 0x0, product version: 2 
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V 155254789, kernel load address: 0x0, kernel entry point: Ox-7FFFE000,2 
Y kernel offset: 3932160, kernel length: 512, rootfs offset: 837431, 7 
y rootfs length: 1048576, bootloader offset: 2883584, bootloader length 


V: 
132096 0x20400 LZMA compressed data, properties: 0x5D, 2 

V dictionary size: 33554432 bytes, uncompressed size: 2388212 bytes 
1180160 0x120200 Squashfs filesystem, little endian, version 7 


y 4.0, compression:lzma, size: 2548511 bytes, 536 inodes, blocksize: 7 
y 131072 bytes, created: 2014-06-27 07:06:52 


Indeed: there are some stuff at the beginning, but two large LZMA compressed 
blocks are started at 0x20400 and 0x120200. These are roughly addresses we have 
seen in Mathematica. Oh, and by the way, binwalk can show entropy information as 
well (-E option): 


DECIMAL HEXADECIMAL ENTROPY 
- 

0 0x0 Falling entropy edge (0.419187) 
16384 0x4000 Rising entropy edge (0.988639) 

51200 0xC800 Falling entropy edge (0.000000) 
133120 0x20800 Rising entropy edge (0.987596) 

968704 OxEC800 Falling entropy edge (0.508720) 
1181696 0x120800 Rising entropy edge (0.989615) 

3727360 0x38E000 Falling entropy edge (0.732390) 


Rising edges are corresponding to rising edges of block on our graph. Falling edges 
are the points where empty lacunas are started. 


Binwalk can also generate PNG graphs (-E -J): 


What can we say about lacunas? By looking in hex editor, we see that these are just 
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filled with OxFF bytes. Why developers put them? Perhaps, because they weren't 
able to calculate precise compressed blocks sizes, so they allocated space for them 
with some reserve. 


Notepad 


Another example is notepad.exe l've picked in Windows 8.1: 


In;2/j (+ that will be the main knob here x) 


fSlider[Dynamic[offset], (0, Length[input] -BlockSize, BlockSize}], 


Out[72]- 4 , 1900016} 


pán 
sort reverse = [E] 


Infs9= (+ main UI part +) 
Dynamic[íListLinePlot[entropies, GridLines > {{-1, offset / BlockSiz 
CurrentBlock = fBlockToShow[input, offset]; 
fPutHexWindow [CurrentBlock] , fPutASCIIWindow [CurrentBlock] }] 


entropy 


8 


(m 


Out[59]- | 


tw 


————————Á————————————— —— . offsel 


e 00 
Dg 


or 
500005000 


D0000000000 


PROOPOOPROODPODPROO 
0000000000000000 
Oroocrocrooroorcoso 
0000000000000000 
O0OOPLOODPRODPROOPODPRO 


0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 


OO0O0O0O0OO* kK OB Rw WU Oo 
DOo00000000000000 
DO000000000000000 
“Oso 
OO0O0O00OK OXF BSORRwU po 
D000000000000000 
D000000000000000 
0001000001 
OO00O000O* OS B Orr OG 
ooo0o0000000000000 
pmpoasmmoaugmaoaoaagaogmnudtczd 
Ow~nooorod-, 
Oo00000OK *OBrPORY DO 
Bamamnugagagagmgogtct 
0o000000000000000 


E 
0 
0 
i 
0 
0 
i 
0 
0 
x 
0 
0 
i 
0 
0 
i 


pon -0OD000001 
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There is cavity at ~ 0719000 (absolute file offset). I've opened the executable file in 
hex editor and found imports table there (which has lower entropy than x86-64 code 
in the first half of graph). 


There are also high entropy block started at « 02720000: 


In;2: (+ that will be the main knob here + 
fSlider[Dynamic[offset], (0, Length[input] -BlockSize, BlockSize)] 


Ou | , 2000016) 


sort reverse t EJ 


n UI part + 


In[jgyz (+ Mair E 
Dynamic[{ListLinePlot[entropies, GridLines > {{-1, offset / BlockSiz 
CurrentBlock = fBlockToShow[input, offset]: 
fPutHexWindow[CurrentBlock], fPutASCIIWindow [CurrentBlock] }] 


entropy 


8 


Out[59)= 4 


tw 


o0o000n01: 0 030w~> 
oo0oo0o00om{Į{x0} 00700040 
DODODORDODODODOO 
BnaogaxaasBsBBous$unu 
DOO0-DOMROnoDoOoDOoKkoOo 
DO0000000A40%000A 
Om+0?2?00$5S0Pmduooo 
oUbp-:- 000001? O0 ^ O0) 
sSununa,n«ae ooo; 
Bpaaaaga:ovaaaaaaBu 
Bnaga«&enuaagagwaagaesonuauu 
a0008y000-S$SOmouooc 
0OO0?20[00000000/0 
DOHO44000000451IA40" 
ne7a«nozuaatrzvusuiuu 
aS8vJunuanosaosanuaduu 


In hex editor | can see PNG file here, embedded in the PE file resource section (it is 
a large image of notepad icon). PNG files are compressed, indeed. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Unnamed dashcam 


Now the most advanced example in this part is the firmware of some unnamed dash- 
cam I’ve received from a friend: 


InB&3:- (+ that will be the main knob here + 


(Slider[Dynamic[offset], (0, Length[input] - BlockSize, BlockSize}], 


ouea Í , 3400016} 


In[s9= (+ main UI part +) 
Dynamic[(ListLinePlot[entropies, GridLines > {{-1, offset /BlockSiz: 
CurrentBlock = fBlockToShow[input, offset]: 
fPutHexWindow [CurrentBlock] , fPutASCIIWindow [CurrentBlock] }] 


entropy 

8.0 

Sn 

7.0 
Ou[sgj- 195 

6.0 

55 

5.0 

A A A i |. Offset 

0 100 200 200 400 500 800 
44 Sf 53 50 49 5f 46 57 32 0 0 0 53 45 4d 49 ([D_SPI_FW2000SEMI 
44 5f 53 50 49 5f 46 57 33 0 0 0 53 45 4d 49| D SPI FW3DOODSEMI 
44 5f 53 50 49 5f 50 53 0 0 0 0 53 45 4d 49| D S PI _PSOOOOSEMI 
44 5f 53 50 49 5f 50 53 32 0 0 0 53 45 4d 49| D SPI PS200DSEMI 
44 5f 53 50 49 5f 50 53 33 0 0 0 53 45 4d 49| D SPI PS3D0OODSEMI 
44 5f 53 50 49 5f 46 41 54 0 0 0 53 45 4d 49| [D_-SPI_FATODOSEMI 
44 5f 53 50 49 5f 46 41 54 32 0 0 53 45 4d 49| D SPI FAT20DSEMI 
44 5f 53 50 49 5f 46 41 54 33 0 0 Se 5225 73| D S PI FATS3DD^RSs[| 
'|3a 3a 25 73 28 29 3a 25 64 2d 45 52 52 3a 2025. |: : #83 () : kd - ERR : 8] 
73 3a 20 53 65 6e 4d 6f 64 65 28 25 64 29 20 6£| |s: SenMode(%d) o 
75 74 20 6f 66 20 72 61 6e 67 65 212121 d a||ut of range!!! 
0 0 0 0 41 52 30 33 33 30 0 0 Se 5225 73| [UDUODARO33000D"RZs 
3a 3a 25 73 28 29 3a 25 64 2d 45 52 52 3a 20 45 £s5():8d-ERR: E 
72 72 6f 72 20 74 72 61 6e 73 6d 69 74 20 64 61] |rror transmit da 
74 61 20 28 77 72 69 74 65 20 61 64 64 7229 21 |ta (write addr): 
21 d a 0 Se 52 25 73 3a 3a 25 73 28 29 3a 25 O*R¢s::%3() 2% 


The cavity at the very beginning is an English text: debugging messages. | checked 
various ISAs and | found that the first third of the whole file (with the text segment 
inside) is in fact MIPS (little-endian) code. 


For instance, this is very distinctive MIPS function epilogue: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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ROM: 
ROM: 
ROM: 
ROM: 
ROM: 
ROM: 
ROM: 


000013B0 
000013B4 
000013B8 
000013BC 
000013C0 
000013C4 
000013C8 


move $sp, 
lw $ra, 
lw $fp, 
lw $s1, 
lw $s0, 
jr $ra 
addiu $sp, 


$fp 
Ox1C($sp) 
0x18($sp) 
0x14($sp) 
0x10($sp) 


0x20 


From our graph we can see that MIPS code has entropy of 5-6 bits per byte. Indeed, 
| once measured various ISAs entropy and I’ve got these values: 


x86: .text section of ntoskrnl.exe file from Windows 2003: 6.6 


x64: .text section of ntoskrnl.exe file from Windows 7 x64: 6.5 

ARM (thumb mode), Angry Birds Classic: 7.05 

ARM (ARM mode) Linux Kernel 3.8.0: 6.03 

* MIPS (little endian), .text section of user32.dll from Windows NT 4: 6.09 


So the entropy of executable code is higher than of English text, but still can be 
compressed. 


Now the second third is started at OXF5000. | don’t know what this is. | tried different 
ISAs but without success. The entropy of the block is looks even steadier than for 
executable one. Maybe some kind of data? 


There is also a spike at « 07213000. | checked it in hex editor and | found JPEG file 
there (which, of course, compressed)! | also don't know what is at the end. Let's try 
Binwalk for this file: 


% binwalk FW96650A.bin 


DESCRIPTION 


DECIMAL HEXADECIMAL 

is 
167698 0x28F12 

S be served.. 
280286 0x446DE 

y Microelectronic Corp." 
2169199 0x21196F 
2300847 0x231BAF 


% binwalk -E FW96650A.bin 


DECIMAL 


2170880 
2267136 
2426880 
2490368 
2560000 


HEXADECIMAL 


0x0 

0x212000 
0x229800 
0x250800 
0x260000 
0x271000 


Unix path: /15/20/24/25/30/60/120/240fps can 7 


Copyright string: "Copyright (c) 2012 Novatek2 


JPEG image data, JFIF standard 1.01 
MySQL MISAM compressed data file Version 3 


ENTROPY 


Falling entropy edge (0.579792) 
Rising entropy edge (0.967373) 
Falling entropy edge (0.802974) 
Falling entropy edge (0.846639) 
Falling entropy edge (0.849804) 
Rising entropy edge (0.974340) 
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2574336 0x274800 Rising entropy edge (0.970958) 
2588672 0x278000 Falling entropy edge (0.763507) 
2592768 0x279000 Rising entropy edge (0.951883) 
2596864 0x27A000 Falling entropy edge (0.712814) 
2600960 0x27B000 Rising entropy edge (0.968167) 
2607104 0x27C800 Rising entropy edge (0.958582) 
2609152 0x27D000 Falling entropy edge (0.760989) 
2654208 0x288000 Rising entropy edge (0.954127) 
2670592 0x28C000 Rising entropy edge (0.967883) 
2676736 0x28D800 Rising entropy edge (0.975779) 
2684928 0x28F800 Falling entropy edge (0.744369) 


Yes, it found JPEG file and even MySQL data! But I’m not sure if it's true—l didn't 
check it yet. 


It's also interesting to try clusterization in Mathematica: 


Infe4j:= (+ le 1 e 1 n clusterir 
ListPlot[FindClusters[entropies]] 


TO .? 
B 
¡ue $ 
. 
> - 
iat ur 
es 
ta *. 
i 
b 
a 
. 
. 
e LJ 
. E 
esL - . 4. á $3s . .. 7 € v? * 
= AA OREA Merete” Ve aa aie 
Out[84]- he Pap * rr^ e$. ceu o * t P aa A v. Noe o” S 
E O NE SINT RU mt vum 
. 
[ . 4*5 » JE A > S 
: . 
eee eee IS i a 
ee? POR et te ow ? oot € 
UNIT RO EcL CR 
Si our ee y, 
| o è e or? 
2 NE ` “ae 
e tht 
*. 
ee .. . 
er LEE 
a 
E 


Here is an example of how Mathematica grouped various entropy values into distinc- 
tive groups. Indeed, there is something credible. Blue dots in range of 5.0-5.5 are 
supposedly related to English text. Yellow dots in 5.5-6 are MIPS code. A lot of green 
dots in 6.0-6.5 is the unknown second third. Orange dots close to 8.0 are related to 
compressed JPEG file. Other orange dots are supposedly related to the end of the 
firmware (unknown to us data). 


Links 


Binary files used in this part: 

https://beginners.re/paywall/REAB- source/current-tree//ff/entropy/files/. 
Wolfram Mathematica notebook file: 
https://beginners.re/paywall/RE4B-source/current-tree//ff/entropy/files/ 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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binary file entropy.nb 
(all cells must be evaluated to start things working). 


9.2.2 Conclusion 


Information entropy can be used as a quick-n-dirty method for inspecting unknown 
binary files. In particular, it is a very quick way to find compressed/encrypted pieces 
of data. Someone say it's possible to find RSA? (and other asymmetric cryptographic 
algorithms) public/private keys in executable code (keys has high entropy as well), 
but I didn't try this myself. 


9.2.3 Tools 


Handy Linux ent utility to measure entropy of a file. 


There is a great online entropy visualizer made by Aldo Cortesi, which | tried to 
mimic using Mathematica: http://binvis.io. His articles about entropy visualiza- 
tion are worth reading: http://corte.si/posts/visualisation/entropy/index. 
html, http://corte.si/posts/visualisation/malware/index.html, http: //corte. 
si/posts/visualisation/binvis/index.html. 


radare2 framework has entropy command for this. 
A tool for IDA: IDAtropy’. 


9.2.4 A word about primitive encryption like XORing 


It's interesting that simple XOR encryption doesn't affect entropy of data. l've shown 
this in Norton Guide example in the book (9.1.2 on page 1172). 


Generalizing: encryption by substitution cipher also doesn't affect entropy of data 
(and XOR can be viewed as substitution cipher). The reason of that is because en- 
tropy calculation algorithm view data on byte-level. On the other hand, the data 
encrypted by 2 or 4-byte XOR pattern will result in another level of entropy. 


Nevertheless, low entropy is usually a good sign of weak amateur cryptography 
(which is also used in license keys/files, etc.). 


9.2.5 More about entropy of executable code 


It is quickly noticeable that probably a biggest source of high-entropy in executable 
code are relative offsets encoded in opcodes. For example, these two consequent 
instructions will have different relative offsets in their opcodes, while they are in fact 
pointing to the same function: 


function proc 


function endp 


5Rivest Shamir Adleman 
Shttp://ww. fourmilab.ch/random/ 
7https://github.com/danigargu/IDAtropy 
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CALL function 


CALL function 


Ideal executable code compressor would encode information like this: there is a 
CALL to a "function" at address X and the same CALL at address Y without necessity 
to encode address of the function twice. 


To deal with this, executable compressors are sometimes able to reduce entropy 
here. One example is UPX: http://sourceforge.net/p/upx/code/ci/default/ 
tree/doc/filter.txt. 

9.2.6 PRNG 


When | run GnuPG to generate new private (secret) key, it asking for some entropy 


We need to generate a lot of random bytes. It is a good idea to perform 
some other action (type on the keyboard, move the mouse, utilize the 
disks) during the prime generation; this gives the random number 
generator a better chance to gain enough entropy. 


Not enough random bytes available. Please do some other work to give 
the OS a chance to collect more entropy! (Need 169 more bytes) 


This means that good a PRNG produces long high-entropy results, and this is what 
the secret asymmetrical cryptographical key needs. But CPRNG? is tricky (because 
computer is highly deterministic device itself), so the GnuPG asking for some addi- 
tional randomness from the user. 


9.2.7 More examples 

Here is a case where | try to calculate entropy of some blocks with unknown contents: 
8.9 on page 1085. 

9.2.8 Entropy of various files 


Entropy of random data is close to 8: 


% dd bs=1M count=1 if-/dev/urandom | ent 
Entropy = 7.999803 bits per byte. 


This means, almost all available space inside of byte is filled with information. 


256 bytes in range of 0..255 gives exact value of 8: 


8Cryptographically secure PseudoRandom Number Generator 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1208 


#!/usr/bin/env python 
import sys 


for i in range(256): 
sys.stdout.write(chr(i)) 


% python 1.py | ent 
Entropy - 8.000000 bits per byte. 


Order of bytes doesn't matter. This means, all available space inside of byte is filled. 


Entropy of any block filled with zero bytes is 0: 


% dd bs=1M count=1 if=/dev/zero | ent 
Entropy = 0.000000 bits per byte. 


Entropy of a string constisting of a single (any) byte is 0: 


% echo -n "aaaaaaaaaaaaaaaaaaa" | ent 
Entropy - 0.000000 bits per byte. 


Entropy of base64 string is the same as entropy of source data, but multiplied by 2. 
This is because base64 encoding uses 64 symbols instead of 256. 


% dd bs=1M count=1 if=/dev/urandom | base64 | ent 
Entropy = 6.022068 bits per byte. 


Perhaps, 6.02 is slightly bigger than 6 because padding symbols (=) spoils our statis- 
tics for a little. 


Uuencode also uses 64 symbols: 


% dd bs=1M count=1 if=/dev/urandom | uuencode - | ent 
Entropy = 6.013162 bits per byte. 


This means, any base64 and Uuencode strings can be transmitted using 6-bit bytes 
or characters. 


Any random information in hexadecimal form has entropy of 4 bits per byte: 


% openssl rand -hex $\$$(( 2**16 )) | ent 
Entropy = 4.000013 bits per byte. 


Entropy of randomly picked English language text from Gutenberg library has en- 
tropy « 4.5. The reason of this is because English texts uses mostly 26 symbols, and 
log2(26) =~ 4.7, i.e., you would need 5-bit bytes to transmit uncompressed English 
texts, that would be enough (it was indeed so in teletype era). 


Randomly chosen Russian language text from http: //Lib. ru library is FM.Dostoevsky 
"|diot"?, internally encoded in CP1251 encoding. 


9http://az.lib.ru/d/dostoewskij f m/text 0070.shtml 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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And this file has entropy of x 4.98. Russian language has 33 characters, and log2(33) == 
5.04. But it has unpopular and rare “ë” character. And log2(32) = 5 (Russian alphabet 
without this rare character)—now this close to what we've got. 


However, the text we studying uses “é” letter, but, probably, it's still rarely used 
there. 


The very same file transcoded from CP1251 to UTF-8 gave entropy of « 4.23. Each 
Cyrillic character encoded in UTF-8 is usually encoded as a pair, and the first byte is 
always one of: OxDO or OxD1. Perhaps, this caused bias. 


Let's generate random bits and output them as "T" and "F" characters: 


#!/usr/bin/env python 
import random, sys 


rt="" 
for i in range(102400): 
if random. randint(0,1)==1: 
rt=rt+"T" 
else: 
rt=rt+"F" 
print rt 


Sample: ...TTTFTFTTTFFFTTTFTTTTTTFTTFFTTTFTFTTFTTFFFFFF. . .. 
Entropy is very close to 1 (i.e., 1 bit per byte). 


Let's generate random decimal digits: 


#!/usr/bin/env python 
import random, sys 


rt=" LLI 
for i in range(102400): 

rt=rt+"%d" % random.randint(0,9) 
print rt 


Sample: ...52203466119390328807552582367031963888032.... 
Entropy will be close to 3.32, indeed, this is loga(10). 


9.2.9 Making lower level of entropy 


The author of these lines once saw a software which stored each byte of encrypted 


data in 3 bytes: each has % ae value, so reconstructing encrypted byte back in- 


volving summing up 3 consecutive bytes. Looks absurdly. 


But some people say this was done in order to conceal the very fact the data has 
something encrypted inside: measuring entropy of such block will show much lower 
level of it. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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9.3 Millenium game save file 


The "Millenium Return to Earth" is an ancient DOS game (1991), that allows you to 


mine resources, build ships, equip them and send them on other planets, and so 
on, 


Like many other games, it allows you to save all game state into a file. 
Let's see if we can find something in it. 


101t can be downloaded for free here 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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So there is a mine in the game. Mines at some planets work faster, or slower on 


others. The set of resources is also different. 
Here we can see what resources are mined at the time: 


DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: 2200AD 


HaunmnmnmiErn 
[]-224 5G; En 
liia TER 
Mi TROoOGEnN 
Me THANE 
SuLAHu.A 
Titanium 
[dL Limi r11 Lim 
Lmnmmgm 
Sicicon 
| ROM 
Silver 
HHBemLum 
LATI r1Lim 
ma Limrmn i.m 


-— 


nm 
c. E 


= > 
en > its La -- 
La A Oe, 


“= 


Figure 9.14: Mine: state 1 


Let’s save a game State. This is a file of size 9538 bytes. 


Let's wait some “days” here in the game, and now we've got more resources from 


the mine: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 


emails. Thanks! 


DOSBox 0.74, Cpu speed: = cycles, Frameskip 0, Program: 2200AD m 


HaunmnmnmEern 
[]-224 5; En 
liia TER 
Ni TROGEN 
METHANE 
SuULAWUR 
Titanium 
[dL.Limi mri Lim 
Conner 
Sicticon 
| Pann 
L| LER 
gnam: um 
LATI mum 
uum ean i.m 


Figure 9.15: Mine: state 2 


Let's save game state again. 


Now let's try to just do binary comparison of the save files using the simple DOS/Win- 
dows FC utility: 


..» FC /b 2200save.i.vl 2200SAVE.I.V2 


Comparing files 2200save.i.vl and 2200SAVE.I.V2 
00000016: OD 04 
00000017: 03 04 
0000001C: 1F 1E 
00000146: 27 3B 
00000BDA: OE 16 
00000BDC: 66 9B 
00000BDE: OE 16 
00000BE0: OE 16 
00000BE6: DB 4C 
00000BE7: 00 01 
00000BE8: 99 E8 
00000BEC: A1 F3 
00000BEE: 83 C7 
00000BFB: A8 28 
00000BFD: 98 18 
00000BFF: A8 28 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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00000C01: A8 28 
00000C07: D8 58 
00000C09: E4 A4 
00000COD: 38 B8 
00000COF: E8 68 


The output is incomplete here, there are more differences, but we will cut result to 
show the most interesting. 


In the first state, we have 14 "units" of hydrogen and 102 "units" of oxygen. 


We have 22 and 155 "units" respectively in the second state. If these values are 
saved into the save file, we would see this in the difference. And indeed we do. 
There is OxOE (14) at position OxBDA and this value is 0x16 (22) in the new version 
of the file. This is probably hydrogen. There is 0x66 (102) at position OxBDC in 
the old version and Ox9B (155) in the new version of the file. This seems to be the 
oxygen. 


Both files are available on the website for those who wants to inspect them (or ex- 
periment) more: beginners.re. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Here is the new version of file opened in Hiew, we marked the values related to the 
resources mined in the game: 


Hiew: 2200save.i.v2 


Figure 9.16: Hiew: state 1 


Let's check each of them. 


These are clearly 16-bit values: not a strange thing for 16-bit DOS software where 
the int type has 16-bit width. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Let's check our assumptions. We will write the 1234 (0x4D2) value at the first posi- 
tion (this must be hydrogen): 


Hiew: 2200save.i.v2 


C:\tmp\220@save.i.v2 BIFWO EDITMODE 


Figure 9.17: Hiew: let's write 1234 (0x4D2) there 


Then we will load the changed file in the game and took a look at mine statistics: 


DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: 2200AD "II E: 
‘Hoon 


is T ssp EN 


HaunmnmnmibErn 
[]-224 5; En 
WaTER 
Mi TRoGeEnN 
METHANE 
SuUuLAHuA 


Titanium 
[dL Limi r11 Lim 


, PACAT mnum 
m Limmn i.m 


Figure 9.18: Let's check for hydrogen value 


So yes, this is it. 
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Now let's try to finish the game as soon as possible, set the maximal values every- 
where: 


Figure 9.19: Hiew: let's set maximal values 


OxFFFF is 65535, so yes, we now have a lot of resources: 


DOSBox 0.74, Cpu speed: 


HaunmnmnmibErn 
[]- 2245; En 


Curomi um 
.. ALATINUM 
mmm Ueanium 


Figure 9.20: All resources are 65535 (OxFFFF) indeed 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: 
. Thanks! 
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Let's skip some "days" in the game and oops! We have a lower amount of some 
resources: 


DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: 2200AD 


HaunmnmnmEern 
[]-224 5G; En 
liia TER 
[li TROGEN 
METHANE 
SuULAWUR 
Titanium 
ALuminium 
Conner 
Sicticon 
| mon 
GILER 
Curomi um 
PALATI mnum 
uum ean i.m 


Figure 9.21: Resource variables overflow 


That's just overflow. 


The game's developer supposedly didn't think about such high amounts of resources, 
so there are probably no overflow checks, but the mine is "working" in the game, 
resources are added, hence the overflows. Apparently, it is a bad idea to be that 
greedy. 


There are probably a lot of more values saved in this file. 


So this is very simple method of cheating in games. High score files often can be 
easily patched like that. 


More about files and memory snapshots comparing: 5.10.2 on page 922. 


9.4 fortune program indexing file 


(This part was first appeared in my blog at 25-Apr-2015.) 


fortune is well-known UNIX program which shows random phrase from a collection. 
Some geeks are often set up their system in such way, so fortune can be called after 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1218 
logging on. fortune takes phrases from the text files laying in /usr/share/games/for- 
tunes (as of Ubuntu Linux). Here is example ("fortunes" text file): 


day for firm decisions!!!!! Or is it? 
few hours grace before the madness begins again. 


gift of a flower will soon be made to you. 


20 2002002 


long-forgotten loved one will appear soon. 


Buy the negatives at any price. 


9 
"6 


A tall, dark stranger will have more fun than you. 


9 
"6 


So it is just phrases, sometimes multiline ones, divided by percent sign. The task 
of fortune program is to find random phrase and to print it. In order to achieve this, 
it must scan the whole text file, count phrases, choose random and print it. But 
the text file can get bigger, and even on modern computers, this naive algorithm 
is a bit uneconomical to computer resources. The straightforward way is to keep 
binary index file containing offset of each phrase in text file. With index file, fortune 
program can work much faster: just to choose random index element, take offset 
from there, set offset in text file and read phrase from it. This is actually done in 
fortune program. Let's inspect what is in its index file inside (these are .dat files in 
the same directory) in hexadecimal editor. This program is open-source of course, 
but intentionally, | will not peek into its source code. 


% od -t x1 --address-radix=x fortunes.dat 

000000 00 00 00 02 00 00 O1 af 00 00 00 bb 00 00 00 Of 
000010 00 00 00 00 25 00 OO 00 OO 00 OO OO 00 OO 00 2b 
000020 00 00 00 60 00 00 00 8f 00 00 00 df 00 00 01 14 
000030 00 00 01 48 00 00 01 7c 00 00 01 ab 00 00 01 e6 
000040 00 00 02 20 00 00 02 3b 00 00 02 7a 00 00 02 c5 
000050 00 00 03 04 00 00 03 3d 00 00 03 68 00 00 03 a7 
000060 00 00 03 el 00 00 04 19 00 00 04 2d 00 00 04 7f 
000070 00 00 04 ad 00 00 04 d5 00 00 05 05 00 00 05 3b 
000080 00 00 05 64 00 00 05 82 00 00 05 ad 00 00 05 ce 
000090 00 00 05 f7 00 00 06 1c 00 00 06 61 00 00 06 7a 
0000a0 00 00 06 d1 00 00 07 Oa 00 00 07 53 00 00 07 9a 
0000b0 00 00 07 f8 00 00 08 27 00 00 08 59 00 00 08 8b 
0000c0 00 00 08 aO 00 00 08 c4 OO 00 08 el 00 00 08 f9 
0000d0 00 00 09 27 00 00 09 43 00 00 09 79 00 00 09 a3 
0000e0 00 00 09 e3 00 00 Oa 15 00 00 Oa 4d 00 00 Oa 5e 
0000f0 00 00 Oa 8a 00 00 Oa a6 00 00 Oa bf 00 00 Oa ef 
000100 00 00 Ob 18 00 00 Ob 43 00 00 Ob 61 00 00 Ob 8e 
000110 00 00 Ob cf 00 00 Ob fa 00 00 Oc 3b 00 00 Oc 66 
000120 00 00 Oc 85 00 00 Oc b9 00 00 Oc d2 00 00 Od 02 
000130 00 00 Od 3b 00 00 Od 67 00 00 Od ac 00 00 Od eb 
000140 00 00 Oe le 00 00 Oe 67 00 00 Oe a5 00 00 Oe da 
000150 00 00 Oe ff 00 00 Of 43 00 00 Of 8a 00 00 Of bc 
000160 00 00 Of e5 00 00 10 le 00 00 10 63 00 00 10 9d 
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000170 00 00 10 e3 00 00 11 10 00 00 11 46 00 00 11 6c 
000180 00 00 11 99 00 00 11 cb 00 00 11 f5 00 00 12 32 
000190 00 00 12 61 00 00 12 8c 00 00 12 ca 00 00 13 87 
0001a0 00 00 13 c4 00 00 13 fc 00 00 14 1a 00 00 14 6f 
0001b0 00 00 14 ae 00 00 14 de 00 00 15 1b 00 00 15 55 
0001cO 00 00 15 a6 00 00 15 d8 00 00 16 Of 00 00 16 4e 


Without any special aid we could see that there are four 4-byte elements on each 
16-byte line. Perhaps, it's our index array. I’m trying to load the whole file in Wolfram 
Mathematica as 32-bit integer array: 


In[]:= BinaryReadList["c:/tmp1/fortunes.dat", "UnsignedInteger32"] 


Out[]2 (33554432, 2936078336, 3137339392, 251658240, 0, 37, 0, \ 
721420288, 1610612736, 2399141888, 3741319168, 335609856, 1208025088, \ 
2080440320, 2868969472, 3858825216, 537001984, 989986816, 2046951424, N 
3305242624, 67305472, 1023606784, 1745027072, 2801991680, 3775070208, \ 
419692544, 755236864, 2130968576, 2902720512, 3573809152, 84213760, \ 
990183424, 1678049280, 2181365760, 2902786048, 3456434176, \ 
4144300032, 470155264, 1627783168, 2047213568, 3506831360, 168230912, \ 
1392967680, 2584150016, 4161208320, 654835712, 1493696512, \ 
2332557312, 2684878848, 3288858624, 3775397888, 4178051072, \ 


Nope, something wrong. Numbers are suspiciously big. But let’s back to od output: 
each 4-byte element has two zero bytes and two non-zero bytes, so the offsets (at 
least at the beginning of the file) are 16-bit at maximum. Probably different endian- 
ness is used in the file? Default endiannes in Mathematica is little-endian, as used 
in Intel CPUs. Now I’m changing it to big-endian: 


In[]:= BinaryReadList["c:/tmp1/fortunes.dat", "UnsignedInteger32", 
ByteOrdering -> 1] 


Out[]= (2, 431, 187, 15, 0, 620756992, 0, 43, 96, 143, 223, 276, N 

328, 380, 427, 486, 544, 571, 634, 709, 772, 829, 872, 935, 993, N 

1049, 1069, 1151, 1197, 1237, 1285, 1339, 1380, 1410, 1453, 1486, \ 
1527, 1564, 1633, 1658, 1745, 1802, 1875, 1946, 2040, 2087, 2137, \ 
2187, 2208, 2244, 2273, 2297, 2343, 2371, 2425, 2467, 2531, 2581, \ 
2637, 2654, 2698, 2726, 2751, 2799, 2840, 2883, 2913, 2958, 3023, \ 
3066, 3131, 3174, 3205, 3257, 3282, 3330, 3387, 3431, 3500, 3552, N 


Yes, this is something readable. | choose random element (3066) which is OxBFA in 
hexadecimal form. I’m opening ‘fortunes’ text file in hex editor, I’m setting OxBFA 
as offset and | see this phrase: 


% od -t x1 -c --skip-bytes=0xbfa --address-radix=x fortunes 
000bfa 44 6f 20 77 68 61 74 20 63 6f 6d 65 73 20 6e 61 


D (0) Ww h a t C (0) m e S n a 
000c0a 74 75 72 61 6c 6c 79 2e 20 20 53 65 65 74 68 65 
t u r a l l y S e e t h e 


000cla 20 61 6e 64 20 66 75 6d 65 20 61 6e 64 20 74 68 
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Or: 


Do what comes naturally. Seethe and fume and throw a tantrum. 


% 


Other offset are also can be checked, yes, they are valid offsets. 


| can also check in Mathematica that each subsequent element is bigger than pre- 
vious. l.e., elements of array are ascending. In mathematics lingo, this is called 
strictly increasing monotonic function. 


In[]:= Differences[input] 


Out[]= (429, -244, -172, -15, 620756992, -620756992, 43, 53, 47, N 
80, 53, 52, 52, 47, 59, 58, 27, 63, 75, 63, 57, 43, 63, 58, 56, 20, 
82, 46, 40, 48, 54, 41, 30, 43, 33, 41, 37, 69, 25, 87, 57, 73, 71, 
94, 47, 50, 50, 21, 36, 29, 24, 46, 28, 54, 42, 64, 50, 56, 17, 44, 
28, 25, 48, 41, 43, 30, 45, 65, 43, 65, 43, 31, 52, 25, 48, 57, 44, 
69, 52, 62, 73, 62, 53, 37, 68, 71, 50, 41, 57, 69, 58, 70, 45, 54, 
38, 45, 50, 42, 61, 47, 43, 62, 189, 61, 56, 30, 85, 63, 48, 61, 58, \ 
81, 50, 55, 63, 83, 80, 49, 42, 94, 54, 67, 81, 52, 57, 68, 43, 28, \ 
120, 64, 53, 81, 33, 82, 88, 29, 61, 32, 75, 63, 70, 47, 101, 60, 79, \ 
33, 48, 65, 35, 59, 47, 55, 22, 43, 35, 102, 53, 80, 65, 45, 31, 29, \ 
69, 32, 25, 38, 34, 35, 49, 59, 39, 41, 18, 43, 41, 83, 37, 31, 34, \ 
59, 72, 72, 81, 77, 53, 53, 50, 51, 45, 53, 39, 70, 54, 103, 33, 70, \ 
51, 95, 67, 54, 55, 65, 61, 54, 54, 53, 45, 100, 63, 48, 65, 71, 23, \ 
28, 43, 51, 61, 101, 65, 39, 78, 66, 43, 36, 56, 40, 67, 92, 65, 61, \ 
31, 45, 52, 94, 82, 82, 91, 46, 76, 55, 19, 58, 68, 41, 75, 30, 67, \ 
92, 54, 52, 108, 60, 56, 76, 41, 79, 54, 65, 74, 112, 76, 47, 53, 61, \ 
66, 53, 28, 41, 81, 75, 69, 89, 63, 60, 18, 18, 50, 79, 92, 37, 63, \ 
88, 52, 81, 60, 80, 26, 46, 80, 64, 78, 70, 75, 46, 91, 22, 63, 46, \ 
34, 81, 75, 59, 62, 66, 74, 76, 111, 55, 73, 40, 61, 55, 38, 56, 47, \ 
78, 81, 62, 37, 41, 60, 68, 40, 33, 54, 34, 41, 36, 49, 44, 68, 51, \ 
50, 52, 36, 53, 66, 46, 41, 45, 51, 44, 44, 33, 72, 40, 71, 57, 55, \ 
39, 66, 40, 56, 68, 43, 88, 78, 30, 54, 64, 36, 55, 35, 88, 45, 56, \ 
76, 61, 66, 29, 76, 53, 96, 36, 46, 54, 28, 51, 82, 53, 60, 77, 21, \ 
84, 53, 43, 104, 85, 50, 47, 39, 66, 78, 81, 94, 70, 49, 67, 61, 37, \ 
51, 91, 99, 58, 51, 49, 46, 68, 72, 40, 56, 63, 65, 41, 62, 47, 41, \ 
43, 30, 43, 67, 78, 80, 101, 61, 73, 70, 41, 82, 69, 45, 65, 38, 41, \ 
57, 82, 66} 


aA A A AA 


As we can see, except of the very first 6 values (which is probably belongs to index 
file header), all numbers are in fact length of all text phrases (offset of the next 
phrase minus offset of the current phrase is in fact length of the current phrase). 


It’s very important to keep in mind that bit-endiannes can be confused with incorrect 
array start. Indeed, from od output we see that each element started with two zeros. 
But when shifted by two bytes in either side, we can interpret this array as little- 
endian: 
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% od -t x1 --address-radix=x --skip-bytes=0x32 fortunes.dat 
000032 01 48 00 00 01 7c 00 00 O1 ab 00 00 01 e6 00 00 
000042 02 20 00 00 02 3b 00 00 02 7a 00 00 02 c5 00 00 
000052 03 04 00 00 03 3d 00 00 03 68 00 00 03 a7 00 00 
000062 03 el 00 00 04 19 00 00 04 2d 00 00 04 7f 00 00 
000072 04 ad 00 00 04 d5 00 00 05 05 00 00 05 3b 00 00 
000082 05 64 00 00 05 82 00 00 05 ad 00 00 05 ce 00 00 
000092 05 f7 00 00 06 1c 00 00 06 61 00 00 06 7a 00 00 
0000a2 06 d1 00 00 07 Oa 00 00 07 53 00 00 07 Ya 00 00 
0000b2 07 f8 00 00 08 27 00 00 08 59 00 00 08 8b 00 00 
0000c2 08 a0 00 00 08 c4 00 00 08 el 00 00 08 f9 00 00 
0000d2 09 27 00 00 09 43 00 00 09 79 00 00 09 a3 00 00 
0000e2 09 e3 00 00 Oa 15 00 00 Oa 4d 00 00 Oa 5e 00 00 


If we would interpret this array as little-endian, the first element is 0x4801, second 
is 0x7CO01, etc. High 8-bit part of each of these 16-bit values are seems random to 
us, and the lowest 8-bit part is seems ascending. 


But I’m sure that this is big-endian array, because the very last 32-bit element of 
the file is big-endian (00 00 5f c4 here): 


% od -t x1 --address-radix=x fortunes.dat 

000660 00 00 59 Od 00 00 59 55 00 00 59 7d 00 00 59 b5 
000670 00 00 59 f4 00 00 5a 35 00 00 5a 5e 00 00 5a 9c 
000680 00 00 5a cb 00 00 5a f4 00 00 5b 1f 00 00 5b 3d 
000690 00 00 5b 68 00 00 5b ab 00 00 5b f9 00 00 5c 49 
0006a0 00 00 5c ae 00 00 5c eb 00 00 5d 34 00 00 5d 7a 
0006b0 00 00 5d a3 00 00 5d f5 00 00 5e 3a 00 00 5e 67 
0006c0 00 00 5e a8 00 00 5e ce 00 00 5e f7 00 00 5f 30 
0006d0 00 00 5f 82 00 00 5f c4 

0006d8 


Perhaps, fortune program developer had big-endian computer or maybe it was ported 
from something like it. 


OK, so the array is big-endian, and, judging by common sense, the very first phrase 
in the text file must be started at zeroth offset. So zero value should be present in 
the array somewhere at the very beginning. We've got couple of zero elements at 
the beginning. But the second is most appealing: 43 is going right after it and 43 is 
valid offset to valid English phrase in the text file. 


The last array element is Ox5FC4, and there are no such byte at this offset in the 
text file. So the last array element is pointing behind the end of file. It's supposedly 
done because phrase length is calculated as difference between offset to the current 
phrase and offset to the next phrase. This can be fasterthan traversing phrase string 
for percent character. But this wouldn't work for the last element. So the dummy 
element is also added at the end of array. 


So the first 6 32-bit integer values are supposedly some kind of header. 


Oh, I forgot to count phrases in text file: 
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% cat fortunes | grep % | wc -1 
432 


The number of phrases can be present in index, but may be not. In case of very 
simple index files, number of elements can be easily deduced from index file size. 
Anyway, there are 432 phrases in the text file. And we see something very familiar 
at the second element (value 431). l've checked other files (literature.dat and rid- 
dles.dat in Ubuntu Linux) and yes, the second 32-bit element is indeed number of 
phrases minus 1. Why minus 1? Perhaps, this is not number of phrases, but rather 
the number of the last phrase (starting at zero)? 


And there are some other elements in the header. In Mathematica, I’m loading each 
of three available files and I’m taking a look on the header: 


n[143:= input = BinaryReadList["c:/tmpi/fortunes.dat", "UnsignedInteger32", 
ByteOrdering 51]: 


n[18]= BaseForm[Take[input, (1, 6)], 16] 


Out[18y/BaseForm- 


1216, 1afie, bbie, fie, O16, 2500000016) 


n[19):= input = BinaryReadList["c:/tmpi/literature.dat", "UnsignedInteger32", 
ByteOrdering 1]: 


i20; BaseForm[Take[input, (1, 6)], 16] 


Out[20y/BaseForm- 
1216, 10616, 98316, laic, O16, 2500000016) 


n[21):= input = BinaryReadLlist["c:/tmpi/riddles.dat", "UnsignedInteger32", ByteOrdering 51]: 


122; BaseForm[Take[input, (1, 6}], 16] 


Out[22y/BaseForm- 


1216, 8016, 7f216, 2416, 01e, 2500000016) 


| have no idea what other values mean, except the size of index file. Some fields are 
the same for all files, some are not. From my own experience, there could be: 


* file signature; 

* file version; 

* checksum; 

* some flags; 

* maybe even text language identifier; 


* text file timestamp, so the fortune program will regenerate index file if a user 
modified text file. 


For example, Oracle .SYM files (9.5 on page 1224) which contain symbols table for 
DLL files, also contain timestamp of corresponding DLL file, so to be sure it is still 
valid. 
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On the other hand, text file and index file timestamps can gone out of sync after 
archiving/unarchiving/installing/deploying/etc. 


But there are no timestamp, in my opinion. The most compact way of representing 
date and time is UNIX time value, which is big 32-bit number. We don't see any of 
such here. Other ways of representation are even less compact. 


So here is algorithm, how fortune supposedly works: 


take number of last phrase from the second element; 


generate random number in range of 0..number of last phrase; 


find corresponding element in array of offsets, take also following offset; 


output to stdout all characters from the text file starting at the offset until the 
next offset minus 2 (so to ignore terminating percent sign and character of the 
following phrase). 


9.4.1 Hacking 


Let's try to check some of our assumptions. I will create this text file under the path 
and name /usr/share/games/fortunes/fortunes: 


Phrase one. 


9 
"6 


Phrase two. 


9 
"6 


Then this fortunes.dat file. | take header from the original fortunes.dat, | changed 
second field (count of all phrases) to zero and | left two elements in the array: 0 and 
Ox1c, because the whole length of the text fortunes file is 28 (Ox1c) bytes: 


% od -t x1 --address-radix=x fortunes.dat 
000000 00 00 00 02 00 00 OO 00 OO 00 OO bb 00 00 00 Of 
000010 00 00 00 00 25 00 OO 00 OO 00 OO OO 00 00 00 1c 


Now | run it: 


% /usr/games/fortune 
fortune: no fortune found 


Something wrong. Let's change the second field to 1: 


% od -t x1 --address-radix=x fortunes.dat 
000000 00 00 00 02 00 00 OO O1 OO OO OO bb OO 00 00 Of 
000010 00 00 00 00 25 00 00 OO OO OO OO OO OO OO 00 1c 


Now it works. It's always shows only the first phrase: 


% /usr/games/fortune 
Phrase one. 


Hmmm. Let's leave only one element in array (0) without terminating one: 
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% od -t x1 --address-radix=x fortunes.dat 

000000 00 00 00 02 00 00 OO O1 OO OO OO bb OO 00 00 Of 
000010 00 00 00 00 25 00 00 00 OO 00 OO 00 

00001c 


Fortune program always shows only first phrase. 


From this experiment we got to know that percent sign in text file is parsed and the 
size is not calculated as | deduced before, perhaps, even terminal array element is 
not used. However, it still can be used. And probably it was used in past? 


9.4.2 The files 


For the sake of demonstration, I still didn't take a look in fortune source code. If you 
want to try to understand meaning of other values in index file header, you may try 
to achieve it without looking into source code as well. Files | took from Ubuntu Linux 
14.04 are here: http://beginners.re/examples/fortune/, hacked files are also 
here. 


Oh, and | took the files from x64 version of Ubuntu, but array elements are still has 
size of 32 bit. It is because fortune text files are probably never exceeds 4GiB!! size. 
But if it will, all elements must have size of 64 bit so to be able to store offset to the 
text file larger than 4GiB. 


For impatient readers, the source code of fortune is here: https://launchpad.net/ 
ubuntu/-*source/fortune-mod/1:1.99.1-3. 1ubuntu4. 


9.5 Oracle RDBMS: .SYM-files 


When an Oracle RDBMS process experiences some kind of crash, it writes a lot of 
information into log files, including stack trace, like this: 


----- Call Stack Trace ----- 


calling call entry argument values in hex 
location type point (? means dubious value) 
PTT P4 
k rU 
_kqvrow() 00000000 
_opifch2()+2729 CALLptr 00000000 23D4B914 E47F264 1F19AE2 
EB1C8A8 1 
_kpoal8 ()+2832 CALLrel _opifch2() 89 5 EB1CC74 
_opiodr()+1248 CALLreg 00000000 5E 1C EB1FOAO 
_ttcpip()+1051 CALLreg 00000000 5E 1C EBIF0AO O 
_opitsk()+1404 CALL??? 00000000 C96C040 5E EB1FOAO O 7 
y EB1ED30 
EB1F1CC 53E52E 0 EB1F1F8 
_opiino()+980 CALLrel — opitsk() 0 0 
_opiodr()+1248 CALLreg 00000000 3C 4 EB1FBF4 
_opidrv()+1201 CALLrel _opiodr() 3C 4 EBIFBF4 O 
HGibibyte 
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_sou20()+55 CALLrel 

_Opimai_real()+124 CALLrel 

_opimai()+125 CALLrel 

_OracleThreadStart@  CALLrel 
S EB1FC34 0 

4()+830 

77E6481C CALLreg 
S EB1FFC4 

00000000 CALL??? 


_opidrv() 
_sou2o() 
_opimai_real() 
_opimai () 


00000000 


00000000 


3C 4 EB1FBF4 

EB1FC04 3C 4 EB1FBF4 
2 EBIFC2C 

2 EBIFF6C 7C88A7F4 7 


EB1FD04 
E41FF9C 0 O E41FF9C 0 2 


But of course, Oracle RDBMS's executables must have some kind of debug informa- 
tion or map files with symbol information included or something like that. 


Windows NT Oracle RDBMS has symbol information in files with .SYM extension, but 
the format is proprietary. (Plain text files are good, but needs additional parsing, 


hence offer slower access.) 


Let’s see if we can understand its format. 


We will pick the shortest orawtc8.sym file that comes with the orawtc8.dll file in 


Oracle 8.1.7 ?2, 


12We can chose an ancient Oracle RDBMS version intentionally due to the smaller size of its modules 
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Here is the file opened in Hiew: 


Hiew: orawtc8.sym 


sym LSS 


Figure 9.22: The whole file in Hiew 


By comparing the file with other .SYM files, we can quickly see that OSYM is always 
header (and footer), so this is maybe the file’s signature. 


We also see that basically, the file format is: OSYM + some binary data + zero de- 
limited text strings + OSYM. The strings are, obviously, function and global variable 
names. 
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We will mark the OSYM signatures and strings here: 


Hiew: orawtc8.sym d 


Figure 9.23: OSYM signature and text strings 


Well, let's see. In Hiew, we will mark the whole strings block (except the trailing 
OSYM signatures) and put it into a separate file. Then we run UNIX strings and wc 
utilities to count the text strings: 


strings strings block | wc -l 
66 


So there are 66 text strings. Please note that number. 


We can say, in general, as a rule, the number of anything is often stored separately 
in binary files. 


It's indeed so, we can find the 66 value (0x42) at the file's start, right after the OSYM 
signature: 


$ hexdump -C orawtc8.sym 
00000000 4f 53 59 4d 42 00 00 00 00 10 00 10 80 10 00 10 |OSYMBY 


| 
00000010 fO 10 00 10 50 11 00 10 60 11 00 10 cO 11 00 10 |....Py 
NEM RPM | 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


00000020 de 11 00 10 70 13 00 10 40 15 00 10 50 15 00 10 |....p...@...P¥ 


b see] 
00000030 60 15 00 10 80 15 00 10 a0 15 00 10 a6 15 00 10 7 
b a | 


Of course, 0x42 here is not a byte, but most likely a 32-bit value packed as little- 
endian, hence we see 0x42 and then at least 3 zero bytes. 


Why do we believe it's 32-bit? Because, Oracle RDBMS's symbol files may be pretty 
big. 

The oracle.sym file for the main oracle.exe (version 10.2.0.4) executable contains 
0x3A38E (238478) symbols. A 16-bit value isn't enough here. 


We can check other .SYM files like this and it proves our guess: the value after the 
32-bit OSYM signature always reflects the number of text strings in the file. 


It’s a general feature of almost all binary files: a header with a signature plus some 
other information about the file. 


Now let's investigate closer what this binary block is. 


Using Hiew again, we put the block starting at address 8 (i.e., after the 32-bit count 
value) ending at the strings block, into a separate binary file. 
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Let's see the binary block in Hiew: 


00000000 : 
00000010: 
00000020: 
00000030: 
00000040: 
00000050: 
00000060: 
00000070: 
00000080: 
00000090: 
00000040: 
000000B0: 
000000C0: 
000000D0 : 
000000E0: 
000000F0 : 
00000100: 
00000110: 
00000120: 
00000130: 
000001490: 
00000150: 
00000160: 
00000170: 
00000180: 
00000190: 
000001A0: 


Figure 9.24: Binary block 


There is a clear pattern in it. 
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We will add red lines to divide the block: 


Hiew: asd2 [ 


a 00000000 


00000000: 10 00 10 10 
00000010: 11 00 10 11 a BB BB B 
00000020: 15 00 10 15 i 
00000030: 15 00 10 15 
00000040: 15 00 10 15 
00000050: 15 00 10 15 
00000060: 17 00 10 17 
00000070: 17 00 10 17 
00000080: 20 00 10 20 
00000090: 20 00 10 20 
00000040: 20 00 10 20 
00000080: 20 00 10 20 
000000C0: 20 00 10 20 
000000D0: 20 00 10 20 
000000E0: 21 00 10 21 
000000F0: 30 00 10 30 
00000100: 30 00 10 30 
00000110: 00 00 00 88 
00000120: 00 00 00 00 
00000130: 00 00 00 00 
00000140: 00 00 00:96 00 
00000150: 00 00 00.CO 00 
00000160: 00 00 00 07 01 
00000170: 01 00 00 2A 01 
00000180: 01 00 00:53 01 
00000190: 01 00 00 C1 01 
000001A0: FB 01 00 00.07 02 
000001B0: 3D 02 00 00.4E 02 
1Gl0ba1 2F1181k 30ryB1k 4:307 
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Figure 9.25: Binary block patterns 


Hiew, like almost any other hexadecimal editor, shows 16 bytes per line. So the 
pattern is clearly visible: there are 4 32-bit values per line. 


The pattern is visually visible because some values here (till address 0x104) are 
always in 0x1000xxxx form, started with Ox10 and zero bytes. 


Other values (starting at 0x108) are in 0x0000xxxx form, so always started with two 
zero bytes. 


Let's dump the block as an array of 32-bit values: 


Listing 9.10: first column is address 


$ od -v -t x4 binary block 
0000000 10001000 10001080 100010f0 10001150 
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0000020 10001160 100011cO 100011d0 10001370 
0000040 10001540 10001550 10001560 10001580 
0000060 100015a0 100015a6 100015ac 100015b2 
0000100 100015b8 100015be 100015c4 100015ca 
0000120 100015d0 100015e0 100016b0 10001760 
0000140 10001766 1000176c 10001780 100017b0 
0000160 100017d0 100017e0 10001810 10001816 
0000200 10002000 10002004 10002008 1000200c 
0000220 10002010 10002014 10002018 1000201c 
0000240 10002020 10002024 10002028 1000202c 
0000260 10002030 10002034 10002038 1000203c 
0000300 10002040 10002044 10002048 1000204c 
0000320 10002050 100020d0 100020e4 100020f8 
0000340 1000210c 10002120 10003000 10003004 
0000360 10003008 1000300c 10003098 1000309c 
0000400 100030a0 100030a4 00000000 00000008 
0000420 00000012 0000001b 00000025 0000002e 
0000440 00000038 00000040 00000048 00000051 
0000460 0000005a 00000064 0000006e 0000007a 
0000500 00000088 00000096 000000a4 000000ae 
0000520 000000b6 000000cO 000000d2 000000e2 
0000540 000000f0 00000107 00000110 00000116 
0000560 00000121 0000012a 00000132 0000013a 
0000600 00000146 00000153 00000170 00000186 
0000620 000001a9 000001c1 000001de 000001ed 
0000640 000001fb 00000207 0000021b 0000022a 
0000660 0000023d 0000024e 00000269 00000277 
0000700 00000287 00000297 000002b6 000002ca 
0000720 000002dc 000002f0 00000304 00000321 
0000740 0000033e 0000035d 0000037a 00000395 
0000760 000003ae 000003b6 000003be 000003c6 
0001000 000003ce 000003dc 000003e9 000003f8 
0001020 


There are 132 values, that's 66*2. Probably, there are two 32-bit values for each 
symbol, but maybe there are two arrays? Let's see. 


Values starting with 0x1000 may be addresses. 


This is a .SYM file for a DLL after all, and the default base address of win32 DLLs is 
0x10000000, and the code usually starts at 0x10001000. 


When we open the orawtc8.dll file in IDA, the base address is different, but never- 
theless, the first function is: 


.text:60351000 sub 60351000 proc near 
.text:60351000 
.text:60351000 arg 0 
.text:60351000 arg 4 
.text:60351000 arg 8 
.text:60351000 


dword ptr 8 
dword ptr OCh 
dword ptr 10h 


.text:60351000 push ebp 
.text:60351001 mov ebp, esp 
.text:60351003 mov eax, dword 60353014 
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.text:60351008 cmp eax, OFFFFFFFFh 
.text:6035100B jnz short loc 6035104F 
.text:6035100D mov ecx, hModule 
.text:60351013 xor eax, eax 

.text:60351015 cmp ecx, OFFFFFFFFh 
.text:60351018 mov dword 60353014, eax 
.text:6035101D jnz short loc 60351031 
.text:6035101F call sub 603510F0 
.text:60351024 mov ecx, eax 

.text:60351026 mov eax, dword 60353014 
.text:6035102B mov hModule, ecx 
.text:60351031 

.text:60351031 loc 60351031: ; CODE XREF: sub 60351000+1D 
.text:60351031 test ecx, ecx 

.text:60351033 jbe short loc 6035104F 
.text:60351035 push offset ProcName ; "ax reg" 
.text:6035103A push ecx ; hModule 
.text:6035103B call ds:GetProcAddress 


Wow, "ax reg" string sounds familiar. 


It’s indeed the first string in the strings block! So the name of this function seems 
to be "ax reg". 


The second function is: 


.text:60351080 sub 60351080 proc near 
.text:60351080 
.text:60351080 arg 0 
.text:60351080 arg 4 
.text:60351080 


dword ptr 8 
dword ptr  0Ch 


.text:60351080 push ebp 

.text:60351081 mov ebp, esp 

.text:60351083 mov eax, dword 60353018 
.text:60351088 cmp eax, OFFFFFFFFh 
.text:6035108B jnz short loc 603510CF 
.text:6035108D mov ecx, hModule 
.text:60351093 xor eax, eax 

.text:60351095 cmp ecx, OFFFFFFFFh 
.text:60351098 mov dword 60353018, eax 
.text:6035109D jnz short loc 603510B1 
.text:6035109F call sub 603510F0 
.text:603510A4 mov ecx, eax 

.text:603510A6 mov eax, dword 60353018 
.text:603510AB mov hModule, ecx 
.text:603510B1 

.text:603510B1 loc 603510B1: ; CODE XREF: sub 60351080+1D 
.text:603510B1 test ecx, ecx 

.text:603510B3 jbe short loc 603510CF 
.text:603510B5 push offset aAx unreg ; "ax unreg" 
.text:603510BA push ecx ; hModule 
.text:603510BB call ds:GetProcAddress 
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The "ax unreg" string is also the second string in the strings block! 


The starting address of the second function is 0x60351080, and the second value in 
the binary block is 10001080. So this is the address, but for a DLL with the default 
base address. 


We can quickly check and be sure that the first 66 values in the array (i.e., the 
first half of the array) are just function addresses in the DLL, including some labels, 
etc. Well, what's the other part of array then? The other 66 values that start with 
0x0000? These seem to be in range [0. . .0x3F8]. And they do not look like bitfields: 
the series of numbers is increasing. 


The last hexadecimal digit seems to be random, so, it's unlikely the address of some- 
thing (it would be divisible by 4 or maybe 8 or 0x10 otherwise). 


Let's ask ourselves: what else Oracle RDBMS's developers would save here, in this 
file? 


Quick wild guess: it could be the address of the text string (function name). 


It can be quickly checked, and yes, each number is just the position of the first 
character in the strings block. 


This is it! All done. 


We will write an utility to convert these .SYM files into IDA script, so we can load the 
.idc script and it sets the function names: 


#include <stdio.h> 
#include <stdint.h> 
#include <io.h> 
#include <assert.h> 
#include <malloc.h> 
#include <fcntl.h> 
#include <string.h> 


int main (int argc, char *argv[]) 
{ 
uint32_t sig, cnt, offset; 
uint32 t *dl, *d2; 
int h, i, remain, file len; 
char *d3; 
uint32 t array size in bytes; 


assert (argv[1]); // file name 
assert (argv[2]); // additional offset (if needed) 


// additional offset 
assert (sscanf (argv[2], "9X", Soffset)==1); 


// get file length 

assert ((h=open (argv[1], _0 RDONLY | 0 BINARY, 0))!--1); 
assert ((file len=1seek (h, 0, SEEK END))!=-1); 

assert (lseek (h, 0, SEEK SET)!--1); 


// read signature 
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assert (read (h, &sig, 4)==4); 
// read count 
assert (read (h, &cnt, 4)==4); 


assert (sig--0x4D59534F); // OSYM 


// skip timedatestamp (for 11g) 
// UVseek (h, 4, 1); 


array size in bytes=cnt*sizeof(uint32 t); 


// load symbol addresses array 

dl-(uint32 t*)malloc (array size in bytes); 

assert (d1); 

assert (read (h, dl, array size in bytes)--array size in bytes); 


// load string offsets array 

d2-(uint32 t*)malloc (array size in bytes); 

assert (d2); 

assert (read (h, d2, array size in bytes)--array size in bytes); 


// calculate strings block size 
remain=file_len- (8+4) -(cnt*8) ; 


// load strings block 
assert (d3=(char*)malloc (remain)); 
assert (read (h, d3, remain)==remain) ; 


printf ("#include <idc.idc>\n\n") ; 
printf ("static main() {\n"); 


for (i=0; i<cnt; i++) 
printf ("NtMakeName(0x9508X, \"%s\");\n", offset + d1l[i], &z 
s d3[d2[i]]); 


printf ("}\n"); 
close (h); 


free (d1); free (d2); free (d3); 
ur 


Here is an example of its work: 


#include <idc.idc> 


static main() { 


MakeName(0x60351000, " ax reg"); 
MakeName(0x60351080, " ax unreg"); 
MakeName(0x603510F0, " loaddll"); 
MakeName(0x60351150, " wtcsrin0"); 
MakeName(0x60351160, " wtcsrin"); 
MakeName(0x603511C0, " wtcsrfre"); 
MakeName(0x603511D0, " wtclkm"); 
MakeName(0x60351370, " wtcstu"); 
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The example files were used in this example are here: beginners.re. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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Oh, let's also try Oracle RDBMS for win64. There has to be 64-bit addresses instead, 
right? 


The 8-byte pattern is visible even easier here: 


oracle.sym 00000000 

00000000: 53 

00000010: 21 

00000020: 20 

00000030: 10 

00000040: 11 

00000050: 13 

00000060: 14 

00000070: 14 

00000080: 1B 

00000090: 1C ene 
00000040: 1C zB 
000000B0: 25 

20020008: 26 

000000D0: 26 

000000E0: 27 

00000OFO : 27 

00000100: 29 

00000110: 2D 

00000120: 2E 

00000130: 30 

00000140: 31 

00000150: 32 

00000160: 33 

00000170: 34 

00000180: 35 

00000190: 36 

00000140: 37 

1Global 2FilBlk 3C 


Figure 9.26: .SYM-file example from Oracle RDBMS for win64 


So yes, all tables now have 64-bit elements, even string offsets! 
The signature is now OSYMAM64, to distinguish the target platform, apparently. 
This is it! 


Here is also library which has functions to access Oracle RDBMS.SYM-files: GitHub. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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9.6 Oracle RDBMS: .MSB-files 


When working toward the solution of a 
problem, it always helps if you know the 
answer. 


Murphy's Laws, Rule of Accuracy 


This is a binary file that contains error messages with their corresponding numbers. 
Let's try to understand its format and find a way to unpack it. 


There are Oracle RDBMS error message files in text form, so we can compare the 
text and packed binary files }°. 


This is the beginning of the ORAUS.MSG text file with some irrelevant comments 
stripped: 


Listing 9.11: Beginning of ORAUS.MSG file without comments 


00000, 00000, "normal, successful completion" 

00001, 00000, "unique constraint (%s.%s) violated" 

00017, 00000, "session requested to set trace event" 

00018, 00000, "maximum number of sessions exceeded" 

00019, 00000, "maximum number of session licenses exceeded" 

00020, 00000, "maximum number of processes (9s) exceeded" 

00021, 00000, "session attached to some other process; cannot switch 7 
S session" 

00022, 00000, "invalid session ID; access denied" 

00023, 00000, "session references process private memory; cannot detach 7 
S session" 

00024, 00000, "logins from more than one process not allowed in single-7 
S process mode" 

00025, 00000, "failed to allocate %s" 

00026, 00000, "missing or invalid session ID" 

00027, 00000, "cannot kill current session" 

00028, 00000, "your session has been killed" 

00029, 00000, "session is not a user session" 

00030, 00000, "User session ID does not exist." 

00031, 00000, "session marked for kill" 


The first number is the error code. The second is perhaps maybe some additional 
flags. 


130pen-source text files don't exist in Oracle RDBMS for every .MSB file, so that's why we will work on 
their file format 
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Now let's open the ORAUS.MSB binary file and find these text strings. And there are: 


Hiew: oraus.msb 


Figure 9.27: Hiew: first block 


We see the text strings (including those from the beginning of the ORAUS.MSG file) 
interleaved with some binary values. By quick investigation, we can see that main 
part of the binary file is divided by blocks of size 0x200 (512) bytes. 
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Let's see the contents of the first block: 


C:\tmp\oraus.msb 00001400 
00001400: 00 00 00-00 
00001410: 00 83 00-12 
00001420: 00 00 00-F5 
00001430: 01 17 00-00 - 
00001440: 00 00 02-6E Binormal, succ 
00001450: 73 73 66-75 essful completio 
00001460: 75 6E 69-71 nunique constrai 
00001470: 74 20 28-25 nt (Xs.Xs) viola 
00001480: 65 64 73-65 tedsession reque 
00001490: 74 65 64-20 sted to set trac 
000014A0: 20 65 76-65 e eventmaximum n 
000014B0: 6D 62 65-72 umber of session 
000014C0: 20 65 78-63 s exceededmaximu 
000014D0: 20 6E 75-6D m number of sess 
000014E0: 6F 6E 20-6C ion licenses exc 
000014F0: 65 64 65-64 eededmaximum num 
00001500: 65 72 20-6F ber of processes 
00001510: 28 25 73-29 (%s) exceededse 
00001520: 73 69 6F-6E ssion attached t 
00001530: 20 73 6F-6D o some other pro 
00001540: 65 73 73-3B cess; cannot swi 
00001550: 63 68 20-73 tch sessioninval 
00001560: 64 20 73-65 id session ID; a 
00001570: 63 65 73-73 ccess deniedsess 
00001580: 6F 6E 20-72 ion references p 
00001590: 6F 63 65-73 rocess private m 
000015A0: 6D 6F 72-79 emory; cannot de 
000015B0: 61 63 68-20 tach sessionlogi 
1870581 2F1181k 30ryB1k 4; j | cu > E 10 leave 1 


Figure 9.28: Hiew: first block 


Here we see the texts of the first messages errors. What we also see is that there 
are no zero bytes between the error messages. This implies that these are not null- 
terminated C strings. As a consequence, the length of each error message must be 
encoded somehow. Let's also try to find the error numbers. The ORAUS.MSG files 
starts with these: 0, 1, 17 (0x11), 18 (0x12), 19 (0x13), 20 (0x14), 21 (0x15), 22 
(0x16), 23 (0x17), 24 (0x18)... We will find these numbers at the beginning of the 
block and mark them with red lines. The period between error codes is 6 bytes. 


This implies that there are probably 6 bytes of information allocated for each error 
message. 


The first 16-bit value (OxA here or 10) means the number of messages in each block: 
this can be checked by investigating other blocks. Indeed: the error messages have 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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arbitrary size. Some are longer, some are shorter. But block size is always fixed, 
hence, you never know how many text messages can be packed in each block. 


As we already noted, since these are not null-terminated C strings, their size must be 
encoded somewhere. The size of the first string "normal, successful completion" is 
29 (Ox1D) bytes. The size of the second string "unique constraint (96s.96s) violated" 
is 34 (0x22) bytes. We can't find these values (Ox1D or/and 0x22) in the block. 


There is also another thing. Oracle RDBMS has to determine the position of the string 
it needs to load in the block, right? The first string "normal, successful completion" 
starts at position 0x1444 (if we count starting at the beginning of the file) or at 
0x44 (from the block's start). The second string "unique constraint (96s.96s) violated" 
starts at position Ox1461 (from the file's start) or at 0x61 (from the at the block's 
start). These numbers (0x44 and 0x61) are familiar somehow! We can clearly see 
them at the start of the block. 


So, each 6-byte block is: 
* 16-bit error number; 
* 16-bit zero (maybe additional flags); 
* 16-bit starting position of the text string within the current block. 


We can quickly check the other values and be sure our guess is correct. And there 
is also the last "dummy" 6-byte block with an error number of zero and starting 
position beyond the last error message's last character. Probably that's how text 
message length is determined? We just enumerate 6-byte blocks to find the error 
number we need, then we get the text string's position, then we get the position 
of the text string by looking at the next 6-byte block! This way we determine the 
string's boundaries! This method allows to save some space by not saving the text 
string's size in the file! 


It's not possible to say it saves a lot of space, but it's a clever trick. 
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Let's back to the header of .MSB-file: 


EE|Hiew:orausmsb O 011 0 MN 
C:Mtmpyoraus.msb BFRO -------- 00000000 
00000000: 01-13 2 

00000010: 00-00 
00000020: 00-00 
00000030: 00-02 
00000040: 00-84 
00000050: 00-14 
00000060: 00-00 
00000070: 00-00 
00000080: 00-00 
00000090: 00-00 
00000040: 00-00 
000000B0: 00-00 
000000C0 : 00-00 
000000D0: 00-00 
000000E0: 00-00 
000000F0: 00-01 
00000100: 00-00 
00000110: 00-00 
00000120: 00-00 
00000130: 00-00 
00000140: 00-00 
00000150: 00-00 
00000160: 00-00 
00000170: 00-00 
00000180: 00-00 
00000190: 00-00 
000001A0: 00-00 
000001B0: 00-00 

>) feo.) We Reload E: Direct - E 10088811: 


Figure 9.29: Hiew: file header 


Now we can quickly find the number of blocks in the file (marked by red). We can 
checked other .MSB-files and we see that it's true for all of them. 


There are a lot of other values, but we will not investigate them, since our job (an 
unpacking utility) is done. 


If we have to write a .MSB file packer, we would probably have to understand the 
meaning of the other values. 
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There is also a table that came after the header which probably contains 16-bit val- 
ues: 


Janablaxa? 4 rm 


00000800: EE r 
00000810: y4wu4$5 , 52595A5G5 
00000820: : N5V5 ]5/15KSri5X5 | 5 
00000830: : L5151565g6meso$6 
00000840: , 6R6[ 606861 646 L6 
00000850: 16]686«63616687 
00000860: : 270787 !7)71797F7 
00000870: - N7U7^7h7n7u7) 717 
00000880: 8707171747717 
00000890: p7u7€7 - 7E8s8z8u8 
000008A0: =81 813 Lagogogogo 
00090850: #9)9/959>9 
9000080: 

000008D0: 


000008E0: 

000008F0: e«n«u«n«tic Le F< [Ex 
00000900: i«S-M»P»ll»0»3» 
00000910: |>—>4>1 >cob> imp 
00000920: i B2B? pl2324- 24? ; 2D? 
00000930: - M?V?a?1?x?A?M?C? 


00000940: : uj? Bo /AABHALE 
00000950: «Elo lalo Yagaw@c@ 
00000960: - -GGABABABADANAWA 
00000970: | _AFANALAXAHALIARA 
00000980: : 3AnAy4A!A; B^ DDD 
00000990: - | DUF*FBINIVI_JAI 
00000940: i [2334213243423 2 
000009B0: L333-3-3 [JpJuJ1J 


> 


lao0Dal ¿FIIDIRK >CPYDTEK : óLeave 


Figure 9.30: Hiew: last errnos table 


Their size can be determined visually (red lines are drawn here). 


While dumping these values, we have found that each 16-bit number is the last error 
code for each block. 


So that's how Oracle RDBMS quickly finds the error message: 


* load a table we will call last errnos (that contains the last error number for each 
block); 


* find a block that contains the error code we need, assuming all error codes 
increase across each block and across the file as well; 


* load the specific block; 
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* enumerate the 6-byte structures until the specific error number is found; 


* get the position of the first character from the current 6-byte block; 
* get the position of the last character from the next 6-byte block; 
* load all characters of the message in this range. 

This is C program that we wrote which unpacks .MSB-files: beginners.re. 


There are also the two files which were used in the example (Oracle RDBMS 11.1.0.6): 
beginners.re, beginners.re. 


9.6.1 Summary 


The method is probably too old-school for modern computers. Supposedly, this file 
format was developed in the mid-80's by someone who also coded for big iron with 
memory/disk space economy in mind. Nevertheless, it has been an interesting and 
yet easy task to understand a proprietary file format without looking into Oracle 
RDBMS's code. 


9.7 Exercises 
Try to reverse engineer of any binary files of your favorite game, including high-score 
files, resources, etc. 


There are also binary files with known structure: utmp/wtmp files, try to understand 
its structure without documentation. 


The EXIF header in JPEG file is documented, but you can try to understand its struc- 
ture without help, just shoot photos at various date/time, places, and try to find 
date/time and GPS location in EXIF. Try to patch GPS location, upload JPEG file to 
Facebook and see, how it will put your picture on the map. 


Try to patch any information in MP3 file and see how your favorite MP3-player will 
react. 


9.8 Further reading 


Pierre Capillon - Black-box cryptanalysis of home-made encryption algorithms: a 
practical case study. 


How to Hack an Expensive Camera and Not Get Killed by Your Wife. 
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Dynamic binary 
instrumentation 


DBI tools can be viewed as highly advanced and fast debuggers. 


10.1 Using PIN DBI for XOR interception 


PIN from Intel is a DBI tool. That means, it takes compiled binary and inserts your 
instructions in it, where you want. 


Let's try to intercept all XOR instructions. These are heavily used in cryptography, 
and we can try to run WinRAR archiver in encryption mode with a hope that some 
XOR instruction is indeed is used while encryption. 


Here is the source code of my PIN tool: https://beginners.re/paywall/REAB- source/ 
current-tree//DBI/XOR/files//XOR ins.cpp. 


The code is almost self-explanatory: it scans input executable file for all XOR/PXOR 
instructions and inserts a call to our function before each. log info() function first 
checks, if operands are different (since XOR is often used just to clear register, like 
XOR EAX, EAX), and if they are different, it increments a counter at this EIP/RIP, so 
the statistics will be gathered. 


| have prepared two files for test: testl.bin (30720 bytes) and test2.bin (5547752 
bytes), I'll compress them by RAR with password and see difference in statistics. 


You'll also need to turn off ASLR !, so the PIN tool will report the same RIPs as in RAR 
executable. 


Now let's run it: 


c:\pin-3.2-81205-msvc-windows\pin.exe -t XOR ins.dll -- rar a -7 
S pLongPassword tmp.rar testl.bin 


lhttps://stackoverflow.com/q/9560993 
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c:\pin-3.2-81205-msvc-windows\pin.exe -t XOR ins.dll -- rar a -7 
S pLongPassword tmp.rar test2.bin 


Now here is statistics for the test1.bin: 

https://beginners. re/paywall/RE4B- source/current-tree//DBI/XOR/files//XOR _ 
ins.out.testl. ... and for test2.bin: 

https://beginners. re/paywall/RE4B- source/current-tree//DBI/XOR/files//XOR _ 
ins.out.test2. So far, you can ignore all addresses other than ip=0x1400xxxxx, 
which are in other DLLs. 


Now let's see a difference: https://beginners. re/paywall/RE4B- source/current-tree/ 
/DBI/XOR/files//XOR ins.diff. 


Some XOR instructions are executed more often for test2.bin (which is bigger) than 
for test1.bin (which is smaller). So these are clearly related to file size! 


The first block of differences is: 


« ip=0x140017b21 count=0xd84 
< ip=0x140017b48 count=0x81f 
< ip=0x140017b59 count=0x858 
< ip=0x140017b6a count=0xc13 
« ip=0x140017b7b count=0xefc 
« ip=0x140017b8a count=0xefd 
< ip=0x140017b92 count=0xb86 
< ip=0x140017ba1 count=0xf01 
> ip-0x140017b21 count=0x9eab5 
> ip-0x140017b48 count=0x79863 
> ip=0x140017b59 count=0x862e8 
> ip=0x140017b6a count=0x99495 
> ip=0x140017b7b count=0xa891c 
> ip=0x140017b8a count=0xa89f4 
> ip-0x140017b92 count=0x8ed72 
> ip=0x140017bal count=0xa8a8a 


This is indeed some kind of loop inside of RAR.EXE: 


.text:0000000140017B21 loc_140017B21: 

.text:0000000140017B21 xor rlld, [rbx] 
.text:0000000140017B24 mov r9d, [rbx+4] 
.text:0000000140017B28 add rbx, 8 
.text:0000000140017B2C mov eax, r9d 

. text :0000000140017B2F shr eax, 18h 

. text :0000000140017B32 movzx edx, al 
.text:0000000140017B35 mov eax, r9d 
.text:0000000140017B38 shr eax, 10h 
.text:0000000140017B3B movzx ecx, al 
.text:0000000140017B3E mov eax, r9d 

. text :0000000140017B41 shr eax, 8 

. text :0000000140017B44 mov r8d, [rsi+rdx*4] 
.text:0000000140017B48 xor r8d, [rsi+rcx*4+400h] 
.text:0000000140017B50 movzx ecx, al 
.text:0000000140017B53 mov eax, rild 
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.text:0000000140017B56 shr eax, 18h 
.text:0000000140017B59 xor r8d, [rsi+rcx*4+800h] 
. text :0000000140017B61 movzx ecx, al 
.text:0000000140017B64 mov eax, riid 

. text :0000000140017B67 shr eax, 10h 

. text :0000000140017B6A xor r8d, [rsi+rcx*4+1000h] 
. text :0000000140017B72 movzx ecx, al 
.text:0000000140017B75 mov eax, rlld 
.text:0000000140017B78 shr eax, 8 
.text:0000000140017B7B xor r8d, [rsi+rcx*4+1400h] 
.text:0000000140017B83 movzx ecx, al 
.text:0000000140017B86 movzx eax, r9b 

. text: 0000000140017B8A xor r8d, [rsi+rcx*4+1800h] 
. text :0000000140017B92 xor r8d, [rsi+rax*4+0C00h] 
. text :0000000140017B9A movzx eax, rllb 
.text:0000000140017B9E mov rlld, r8d 
.text:0000000140017BA1 xor rlld, [rsi+rax*4+1C00h] 
. text :0000000140017BA9 sub rdi, 1 

. text: 0000000140017BAD jnz loc 140017B21 


What does it do? No idea yet. 
The next: 


< ip=0x14002c4f1 count=0x4fce 


> ip=0x14002c4f1 count=0x4463be 


Ox4fce is 20430, which is close to size of testl.bin (30720 bytes). 0x4463be is 
4481982 which is close to size of test2.bin (5547752 bytes). Not equal, but close. 


This is a piece of code with that XOR instruction: 


. text: 000000014002C4EA loc 14002C4EA: 


. text :000000014002C4EA movzx eax, byte ptr [r8] 

. text :000000014002C4EE shl ecx, 5 

. text: 000000014002C4F1 xor ecx, eax 

. text :000000014002C4F3 and ecx, 7FFFh 

. text :000000014002C4F9 cmp [rll+rcx*4], esi 

. text :000000014002C4FD jb short loc 14002C507 
. text :000000014002C4FF cmp [r1l+rcx*4], rl0d 

. text :000000014002C503 ja short loc 14002C507 
.text:000000014002C505 inc ebx 


Loop body can be written as: 


state = input byte ^ (state<<5) € Ox7FFFj. 


state is then used as index in some table. Is this some kind of CRC?? | don't know, 
but this could be a checksumming routine. Or maybe optimized CRC routine? Any 


ideas? 
The next block: 


2Cyclic redundancy check 
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« ip-0x14004104a count=0x367 
« ip=0x140041057 count=0x367 
> ip=0x14004104a count=0x24193 
> ip=0x140041057 count=0x24193 


. text: 0000000140041039 
. text :000000014004103C 
. text : 0000000140041040 
. text: 0000000140041044 
. text : 0000000140041048 
. text :000000014004104A 
. text: 000000014004104E 


. text :000000014004104E 
. text :0000000140041053 
. text: 0000000140041057 
. text: 000000014004105B 
. text: 000000014004105F 
. text :0000000140041061 
. text: 0000000140041065 
. text :0000000140041069 


. text :0000000140041069 
. text :000000014004106D 
. text :0000000140041071 
. text :0000000140041076 
. text :000000014004107A 
. text : 000000014004107C 


. text: 0000000140041039 loc 140041039: 


. text: 000000014004104E loc 14004104E: 


. text: 0000000140041069 loc 140041069: 


movdqu 
movsxd 
pxor 
cmp 
jle 
lea 
lea 


movdqu 
lea 
aesenc 
sub 
jnz 


rax, r10 

r10, 10h 

byte ptr [rcx+1], 0 
xmm0, xmmword ptr [rax] 
short loc 14004104E 
xmmO, xmml 


xmml1, xmmword ptr [rcx+18h] 
r8, dword ptr [rcx+4] 

xmml, xmm0 

r8d, 1 

short loc 14004107C 

rdx, [rcx+28h] 

r9d, [r8-1] 


xmm0, xmmword ptr [rdx] 
rdx, [rdx+10h] 

xmml, xmm0 

r9, 1 

short loc 140041069 


This piece has both PXOR and AESENC instructions (the last is AES? encryption in- 
struction). So yes, we found encryption function, RAR uses AES. 


There is also another big block of almost contiguous XOR instructions: 


« ip=0x140043e10 count=0x23006 
> ip=0x140043e10 count=0x23004 
499c510 

< ip=0x140043e56 count=0x22ffd 


> ip=0x140043e56 count=0x23002 


But, its count is not very different during compressing/encrypting test1.bin/test2.bin. 


What is on these addresses? 


. text :0000000140043E07 
. text :0000000140043E0A 
. text :0000000140043E0D 
. text :0000000140043E10 


3Advanced Encryption Standard 


xor 
mov 
and 
xor 


ecx, r9d 
rlld, eax 
ecx, r10d 
ecx, r8d 
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.text:0000000140043E13 rol eax, 8 
.text:0000000140043E16 and eax, esi 
.text:0000000140043E18 ror rild, 8 
.text:0000000140043E1C add edx, 5A827999h 
.text:0000000140043E22 ror ri0d, 2 
.text:0000000140043E26 add r8d, 5A827999h 
.text:0000000140043E2D and rlld, r12d 

. text: 0000000140043E30 or rlld, eax 

. text :0000000140043E33 mov eax, ebx 


Let’s google 5A827999h constant... this looks like SHA-1! But why would RAR use 
SHA-1 during encryption? 


Here is the answer: 


In comparison, WinRAR uses its own key derivation scheme that requires (7 
Y password length * 2 + 11)*4096 SHA-1 transformations. "Thats why it 7 
V takes longer to brute-force attack encrypted WinRAR archives. 


(http://www. tomshardware.com/reviews/password- recovery-gpu, 2945- 8. html 


) 


This is key scheduling: input password hashed many times and the hash is then used 
as AES key. This is why we see the count of XOR instruction is almost unchanged 
during we switched to bigger test file. 


This is it, ittook couple of hours for me to write this tool and to get at least 3 points: 1) 
probably checksumming; 2) AES encryption; 3) SHA-1 calculation. The first function 
is still unknown for me. 


Still, this is impressive, because I didn't dig into RAR code (which is proprietary, of 
course). | didn't even peek into UnRAR source code (which is available). 


The files, including test files and RAR executable I’ve used (win64, 5.40): 
https://beginners.re/paywall/REAB- source/current-tree//DBI/XOR/files/. 


10.2 Cracking Minesweeper with PIN 


In this book, I wrote about cracking Minesweeper for Windows XP: 8.4 on page 1021. 


The Minesweeper in Windows Vista and 7 is different: probably it was (re)written to 
C++, and a cell information is now stored not in global array, but rather in malloc'ed 
heap blocks. 


This is a case when we can try PIN DBI tool. 


10.2.1 Intercepting all rand() calls 


First, since Minesweeper places mines randomly, it has to call rand() or similar func- 
tion. Let's intercept all rand() calls: https://beginners.re/paywall/RE4B- source/ 
current -tree//DBI/minesweeper/minesweeperl. cpp. 


Now we can run it: 
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c:\pin-3.2-81205-msvc-windows\pin.exe -t minesweeperl.dll -- C:\PATH\TO\/ 
\ MineSweeper.exe 


During startup, PIN searches for all calls to rand() function and adds a hook right after 

each call. The hook is the RandAfter() function we defined: itis logging about return 

value and also about return address. Here is a log | got during run of standard 9*9 
configuration (10 mines): https://beginners. re/paywall/RE4B- source/current-tree/ 
/DBI/minesweeper/minesweeperl.out.10mines. The rand() function was called 

many times from several places, but was called from 0x10002770d just 10 times. 

| switched Minesweeper to 16*16 configuration (40 mines) and rand() was called 

from 0x10002770d 40 times. So yes, this is our point. When | load minesweeper.exe 

(from Windows 7) into IDA and PDB from Microsoft website is fetched, the function 

which calls rand() at 0x10002770d called Board::placeMines(). 


10.2.2 Replacing rand() calls with our function 


Let's now try to replace rand() function with our version, let it always return zero: 
https://beginners.re/paywall/REAB- source/current-tree//DBI/minesweeper/ 
minesweeper2.cpp. During startup, PIN replaces all calls to rand() to calls to our 
function, which writes to log and returns zero. OK, I run it, and clicked on leftmost/- 
topmost cell: 


Game Help 


$ E > + + + 2 


Yes, unlike Minesweeper from Windows XP, mines are places randomly after user’s 
click on cell, so to guarantee there is no mine at the cell user first clicked. So 
Minesweeper placed mines on cells other than leftmost/topmost (where | clicked). 


Now | clicked on rightmost/topmost cell: 
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5: Minesweeper - [Bl x| 


Game Help 


This can be some kind of practical joke? | don't know. 
| clicked on 5th cell (right at the middle) at the 1st row: 


BITES 


Game Help 


> 


42! 
213/2111 [1/1/11 | 
Em 


This is nice, because Minesweeper can do some correct placement even with such 


a broken PRNG! 


10.2.3 Peeking into placement of mines 


How can we get information about where mines are placed? rand()'s result is seems 
to be useless: it returned zero all the time, but Minesweeper somehow managed to 
place mines in different cells, though, lined up. 


This Minesweeper also written in C++ tradition, so it has no global arrays. 


Let us put ourselves in the position of programmer. It has to be loop like: 


for (int i; i«mines total; i++) 


{ 


// get coordinates using rand() 


// put a cell: in other words, modify a block allocated in heap 


$; 
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How can we get information about heap block which gets modified at the 2nd step? 
What we need to do: 1) track all heap allocations by intercepting malloc()/realloc()/free(). 
2) track all memory writes (slow). 3) intercept calls to rand(). 


Now the algorithm: 1) mark all heap blocks gets modified between 1st and 2nd call 
to rand() from 0x10002770d; 2) whenever heap block gets freed, dump its contents. 


Tracking all memory writes is slow, but after 2nd call to rand(), we don't need to 
track it (since we've got already a list of blocks of interest at this point), so we turn 
it off. 


Now the code: https://beginners.re/paywall/REAB- source/current-tree//DBI/ 
minesweeper/minesweeper3.cpp. 


As it turns out, only 4 heap blocks gets modified between first two rand() calls, this 
is how they looks like: 


free(0x20aa6360) 

free(): we have this block in our records, size=0x28 

0x20AA6360: 36 00 00 00 4E 00 00 00-2D 00 00 00 29 00 00 00 "6...N...-...)2 
Ko aston 

0x20AA6370: 06 00 00 00 37 00 00 00-35 00 00 00 19 00 00 00 2 
SHE DNI TREE CRM $ 

0x20AA6380: 46 00 00 00 OB 00 00 00- A y 
G " 


free(0x20af9d10) 

free(): we have this block in our records, size=0x18 

Ox20AF9D10: OA 00 00 00 OA 00 00 00-0A OO 00 00 00 00 00 00 7 
a a " 

0x20AF9D20: 60 63 AA 20 00 00 00 00- UC elos 2 
s u 


free(0x20b28b20) 
free(): we have this block in our records, size=0x140 

0x20B28820: 02 00 00 00 03 00 00 00-04 00 00 00 05 00 00 00 » 
0x20828830: 07 00 00 00 08 00 00 00-0C 00 00 00 OD 00 00 00 » 
ox20828B40: E 00 00 00 OF 00 00 00-10 00 00 00 11 00 00 00 » 
ox20828850; 12 00 00 00 13 00 00 00-14 00 00 00 15 00 00 00 » 
ox20828860; 16 00 00 00 17 00 00 00-18 00 00 00 1A 00 00 00 » 
0x20829870: 18 00 00 00 1C 00 00 00-1D 00 00 00 1E 00 00 00 v 
0x20B28B80: 1F 00 00 00 20 00 00 00-21 00 00 00 22 00 00 00 ".... » 
E 00 00 24 00 00 00-25 00 00 00 26 00 00 00 "£...$7 

PT ME TEE 
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0x20B28BA0: 27 00 00 00 28 00 00 00-2A 00 00 00 2B 00 00 00 7 


a es uet 
0x20B28BB0: 2C 00 00 00 2E 00 00 00-2F 00 00 00 30 00 00 00 v 
a acing cec fa 30. ^ 


0x20B28BCO: 31 00 00 00 32 00 00 00-33 00 00 00 34 00 00 00 » 
ox20828800: 38 00 00 09 39 00 00 00-3A 00 00 00 3B 00 00 00 » 
ox20829860: 3t 00 00 00 30 00 00 00-3E 00 00 00 3F 00 00 00 » 
6x208286"0: 46 00 00 06 41 00 00 00-42 00 00 00 43 00 00 00 "Q...A...B...C7 
Ox20B28C00: 44 00 00 00 45 00 00 00-47 00 00 00 48 09 00 00 "D...E...G...H7 


ox20828Ci0 49 00 00 00 4A 00 00 00-4B 00 00 00 4C 00 00 00 "I...J...K...L7 
0x20828¢20: 4D 00 00 00 4F 00 00 00-50 00 00 00 50 00 00 00 "M...0...P...P 
0x20828C30 50 00 00 00 50 00 00 00-50 00 00 00 50 00 00 00 "P...P...P...PZ 
ox20828C40 50 00 00 00 50 00 00 00-50 00 00 00 50 00 00 00 "P...P...P...P7 
Ox20828C50: 50 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 “PY 


free(0x20af9cf0) 

free(): we have this block in our records, size=0x18 

Ox20AF9CFO: 43 00 00 00 50 00 00 00-10 00 00 00 20 00 74 00 "C...P....... iv 
S t. "n 

0x20AF9D00: 20 8B B2 20 00 00 00 00- Men adria 2 
Ns. u 


We can easily see that the biggest blocks (with size 0x28 and 0x140) are just arrays 
of values up to ~ 0x50. Wait... 0x50 is 80 in decimal representation. And 9*9=81 
(standard minesweeper configuration). 


After quick investigation, I’ve found that each 32-bit element is indeed cell coordi- 
nate. A cell is represented using a single number, it's a number inside of 2D-array. 
Row and column of each mine is decoded like that: row=n / WIDTH; col=n 96 HEIGHT; 


So when | tried to decode these two biggest blocks, I’ve got these cell maps: 


try to dump cells(). unique elements-0xa 
* 
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try to dump cells(). unique elements-0x44 
x RRR kk 
Qa ERA 
FRAEFER k 
KK K OK KOK OK KK 
RRA KK 
RRR RK 
MEL RRR KK 
FXAEFER > 
RRA kk 


It seems that the first block is just a list of mines placed, while the second block is 
a list of free cells, but, the second is somewhat out of sync with the first one, and 
it’s negative version of the first one coincides only partially. Nevertheless, the first 
map is correct - we can peek into it in log file when Minesweeper is still loaded and 
almost all cells are hidden, and click safely on cells marked as dots here. 


So it seems, when user first clicked somewhere, Minesweeper places 10 mines, than 
destroys the block with a list of it (perhaps, it copies all the data to another block 
before?), so we can see it during free() call. 


Another fact: the method Array «NodeType» ::Add(NodeType) modifies blocks we ob- 
served, and is called from various places, including Board::placeMines(). But what 
is cool: | never got into its details, everything has been resolved using just PIN. 


The files: https://beginners. re/paywall/RE4B- source/current-tree//DBI/minesweeper. 


10.2.4 Exercise 


Try to understand how rand()’s result being converted into coordinate(s). As a prac- 
tical joke, make rand() to output such results, so mines will be placed in shape of 
some symbol or figure. 


10.3 Building Intel Pin 


Building Intel Pin for Windows may be tricky. This is my working recipe. 
* Unpack the latest Intel Pin to, say, C:\pin-3.20\ 
e Install latest Cygwin, to, say, c:\cygwin64 
* Install MSVC 2015 or newer. 


(If needed) inC:\pin-3.20\source\tools\SimpleExamples\makefile. rules, 
add your pintool to the TEST TOOL ROOTS list. 


* Open "VS2015 x86 Native Tools Command Prompt". Type: 


set PATH=%PATH%;c:\cygwin64/bin 
cd c:\pin-3.20\source\tools 
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| make all TARGET=ia32 | 


(It will require many UNIX utilities, which are available under c:\cygwin64\bin 
path. Hence the PATH variable is to be modified.) 


Now pintools are now in c:\pin-3.20\source\tools\...\obj-ia32 


For winx64, use "x64 Native Tools Command Prompt" and run: 


make all TARGET=intel64 


* Run a pintool: 


c:\pin-3.20\pin.exe -t C:\pin-3.20\source\tools\SimpleExamples\obj -ia327 
Y NXOR ins.dll -- program.exe arguments 


Intel Pin 3.20 require at least Windows 10. On Windows 7 you may got an error like: 


A: source\pincrt\injector_w\maincrt_windows.cpp: LEVEL BASE::RootMain: 139:7 
Y assertion failed: NT SUCCESS(ntStatus) 


NO STACK TRACE AVAILABLE 


It also works in Windows Sever 2012. 


10.4 Why "instrumentation"? 


Perhaps, this is a term of code profiling. There are at least two methods: 1) "sam- 
pling": you break into running code as many times as possible (hundreds per sec- 
ond), and see, where it is executed at the moment; 2) "instrumentation": compiled 
code is interleaved with other code, which can increment counters, etc. 


Perhaps, DBI tools inherited the term? 
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Other things 


11.1 Using IMUL over MUL 


Example like listing.3.23.2 where two unsigned values are multiplied compiles into 
listing.3.23.2 where IMUL is used instead of MUL. 


This is important property of both MUL and IMUL instructions. First of all, they both 
produce 64-bit value if two 32-bit values are multiplied, or 128-bit value if two 64-bit 
values are multiplied (biggest possible product in 32-bit environment is 
Oxffffffff*Oxffffffff-Oxfffffffe00000001). But C/C++ standards have no way 
to access higher half of result, and a product always has the same size as multipli- 
cands. And both MUL and IMUL instructions works in the same way if higher half is 
ignored, i.e., they both generate the same lower half. This is important property of 
"two's complement" way of representing signed numbers. 


So C/C++ compiler can use any of these instructions. 


But IMUL is more versatile than MUL because it can take any register(s) as source, 
while MUL requires one of multiplicands stored in AX/EAX/RAX register. Even more than 
that: MUL stores result in EDX:EAX pair in 32-bit environment, or RDX:RAX in 64-bit 
one, so it always calculates the whole result. On contrary, it's possible to set a single 
destination register while using IMUL instead of pair, and then CPU will calculate 
only lower half, which works faster [see Torborn Granlund, Instruction latencies and 
throughput for AMD and Intel x86 processors!). 


Given that, C/C++ compilers may generate IMUL instruction more often then MUL. 


Nevertheless, using compiler intrinsic, it's still possible to do unsigned multiplication 
and get full result. This is sometimes called extended multiplication. MSVC has 
intrinsic for this called | emul? and another one:  umul128?. GCC offer  int128 
data type, and if 64-bit multiplicands are first promoted to 128-bit ones, then a 


lhttp://yurichev.com/mirrors/x86- timing. pdf] 
?https://msdn.microsoft.com/en-us/library/d2s81xt0(v-vs.80) .aspx 
3https://msdn.microsoft.com/library/3dayytw9%28v=vs . 1005529 . aspx 
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product is stored into another _ ínt128 value, then result is shifted by 64 bits right, 
you'll get higher half of result^. 


11.1.1 MulDiv() function in Windows 


Windows has MulDiv() function °, fused multiply/divide function, it multiplies two 
32-bit integers into intermediate 64-bit value and then divides it by a third 32-bit 
integer. It is easier than to use two compiler intrinsic, so Microsoft developers made 
a special function for it. And it seems, this is busy function, judging by its usage. 


11.2 Executable files patching 
11.2.1 x86 code 


Frequent patching tasks are: 


One of the most frequent jobs is to disable some instruction. It is often done by 
filling it using byte 0x90 (NOP). 


Conditional jumps, which have an opcode like 74 xx (JZ), can be filled with two 
NOPs. 


It is also possible to disable a conditional jump by writing O at the second byte 
(jump offset). 


Another frequent job is to make a conditional jump to always trigger: this can 
be done by writing OxEB instead of the opcode, which stands for JMP. 


A function's execution can be disabled by writing RETN (0xC3) at its beginning. 
This is true for all functions excluding stdcall (6.1.2 on page 932). While patch- 
ing stdcall functions, one has to determine the number of arguments (for ex- 
ample, by finding RETN in this function), and use RETN with a 16-bit argument 
(0xC2). 


Sometimes, a disabled functions has to return O or 1. This can be done by MOV 
EAX, O or MOV EAX, 1, but it's slightly verbose. 

A better way is XOR EAX, EAX (2 bytes 0x31 0xC0) or XOR EAX, EAX / INC 
EAX (3 bytes 0x31 0xC0 0x40). 


A software may be protected against modifications. 


This protection is often done by reading the executable code and calculating a check- 
sum. Therefore, the code must be read before protection is triggered. 


This can be determined by setting a breakpoint on reading memory. 
tracer has the BPM option for this. 


PE executable file relocs (6.5.2 on page 967) must not to be touched while patching, 
because the Windows loader may overwrite your new code. (They are grayed in 
Hiew, for example: fig.1.21). 


^Example: http: //stackoverflow.com/a/13187798 
Shttps://msdn.microsoft.com/en-us/library/windows/desktop/aa383718(v=vs.85) .aspx 
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As a last resort, it is possible to write jumps that circumvent the relocs, or you will 
have to edit the relocs table. 


11.3 Function arguments number statistics 


l've always been interesting in what is average number of function arguments. 


l've analyzed many Windows 7 32-bit DLLs 

(crypt32.dll, mfc71.dll, msvcr100.dll, shell32.dll, user32.dll, d3d11.dll, mshtml.dll, 
msxml6.dll, sqinclil1.dll, wininet.dll, mfc120.dll, msvbvm60.dll, ole32.dll, themeui.dll, 
wmp.dll) (because they use stdcall convention, and so it is easy to grep disassembly 
output just by RETN X). 


* no arguments: « 2996 
e 1 argument: « 23% 

* 2 arguments: « 2096 
* 3 arguments: « 1196 
* 4 arguments: « 7% 

* 5 arguments: « 396 

* 6 arguments: « 2% 


* 7 arguments: « 196 


Figure 11.1: Function arguments number statistics 


This is heavily dependent on programming style and may be very different for other 
software products. 
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11.4 Compiler intrinsic 


A function specific to a compiler which is not an usual library function. The compiler 
generates a specific machine code instead of a call to it. It is often a pseudofunction 
for specific CPU instruction. 


For example, there are no cyclic shift operations in C/C++ languages, but they are 
present in most CPUs. For programmer's convenience, at least MSVC has pseud- 


ofunctions _rotl() and _rotr()° which are translated by the compiler directly to the 
ROL/ROR x86 instructions. 


Another example are functions to generate SSE-instructions right in the code. 
Full list of MSVC intrinsics: MSDN. 


11.5 Compiler’s anomalies 


11.5.1 Oracle RDBMS 11.2 and Intel C++ 10.1 


Intel C++ 10.1, which was used for Oracle RDBMS 11.2 Linux86 compilation, may 
emit two JZ in row, and there are no references to the second JZ. The second JZ is 
thus meaningless. 


Listing 11.1: kdli.o from libserver11.a 


.text:08114CF1 loc 8114CF1: 

CODE XREF: PGOSF539 kdlimemSer+89A 
.text:08114CF1 ; PGOSF539 kdlimemSer+3994 
.text:08114CF1 8B 45 08 mov eax, [ebp+arg_0] 
.text:08114CF4 OF B6 50 14 movzx edx, byte ptr [eax+14h] 
.text:08114CF8 F6 C2 01 test dl, 1 
.text:08114CFB OF 85 17 08 00 00 jnz loc 8115518 
.text:08114D01 85 C9 test ecx, ecx 
.text:08114D03 OF 84 8A 00 00 00 jz loc 8114D93 
.text:08114D09 OF 84 09 08 00 00 jz loc 8115518 
.text:08114D0F 8B 53 08 mov edx, [ebx+8] 
.text:08114D12 89 55 FC mov [ebp-var 4], edx 
.text:08114D15 31 CO xor eax, eax 
.text:08114D17 89 45 F4 mov [ebp-var C], eax 
.text:08114D1A 50 push eax 
.text:08114D1B 52 push edx 
.text:08114D1C E8 03 54 00 00 call len2nbytes 
.text:08114D21 83 C4 08 add esp, 8 


Listing 11.2: from the same code 


.text:0811A2A5 loc 811A2A5: ; CODE XREF: kdliSerLengths+11C 
.text:0811A2A5 ; kdliSerLengths+1C1 
.text:0811A2A5 8B 7D 08 mov edi, [ebp«arg 0] 
.text:0811A2A8 8B 7F 10 mov edi, [edi+10h] 

°MSDN 
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.text:0811A2AB OF B6 57 14 movzx edx, byte ptr [edi+14h] 
.text:0811A2AF F6 C2 01 test dl, 1 

.text:0811A2B2 75 3E jnz short loc 811A2F2 
.text:0811A2B4 83 EO 01 and eax, 1 

.text:0811A2B7 74 1F jz short loc 811A2D8 
.text:0811A2B9 74 37 jz short loc 811A2F2 
.text:0811A2BB 6A 00 push 0 

.text:0811A2BD FF 71 08 push dword ptr [ecx+8] 
.text:0811A2C0 E8 5F FE FF FF call len2nbytes 


It is supposedly a code generator bug that was not found by tests, because resulting 
code works correctly anyway. 


Another example from Oracle RDBMS 11.1.0.6.0 for win32. 


.text:0051FBF8 85 CO test eax, eax 
.text:0051FBFA OF 84 8F 00 00 00 jz loc 51FC8F 
.text:0051FC00 74 1D jz short loc 51FCIF 


11.5.2 MSVC 6.0 


Just found in some old code: 


fabs 

fild [esp+50h+var_ 34] 

fabs 

fxch st(1) ; first instruction 
fxch st(1) ; second instruction 


faddp st(1), st 

fcomp [esp+50h+var_ 3C] 
fnstsw ax 

test ah, 41h 

jz short loc 100040B7 


The first FXCH instruction swaps ST(0) and ST(1), the second do the same, so both 
do nothing. This is a program uses MFC42.dll, so it could be MSVC 6.0, 5.0 or maybe 
even MSVC 4.2 from 1990s. 


This pair do nothing, so it probably wasn't caught by MSVC compiler tests. Or maybe 
| wrong? 
11.5.3 ftol2() in MSVC 2012 


Just found this in ftol2() standard C/C++ library function (float-to-long conversion 
routine) in Microsoft Visual Studio 2012. 


public  ftol2 


. ftol2 proc near 
push ebp 
mov ebp, esp 
sub esp, 20h 
and esp, OFFFFFFFOh 
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fld 
fst 
fistp 
fild 
mov 
mov 
test 
jz 


arg is not integer QnaN: 
fsubp 
test 
jns 
fstp 
mov 
xor 
add 
adc 
mov 
adc 
jmp 


positive: 
fstp 
mov 
add 
sbb 
mov 
sbb 
jmp 


integer QnaN or zero: 
mov 
test 
jnz 
fstp 
fstp 


localexit: 
leave 
retn 
. ftol2 endp 


st 

dword ptr [esp+18h] 

qword ptr [esp+10h] 

qword ptr [esp+10h] 

edx, [esp+18h] 

eax, [esp+10h] 

eax, eax 

short integer QnaN or zero 


st(1), st 

edx, edx 

short positive 

dword ptr [esp] 
ecx, [esp] 

ecx, 80000000h 

ecx, 7FFFFFFFh 

eax, 0 

edx, [esp+14h] 

edx, 0 

short localexit 


dword ptr [esp] 
ecx, [esp] 

ecx, 7FFFFFFFh 

eax, 0 

edx, [esp+14h] 

edx, 0 

short localexit 


edx, [esp+14h] 

edx, 7FFFFFFFh 

short arg is not integer QnaN 
dword ptr [esp+18h] ; first 
dword ptr [esp+18h] ; second 


Note two identical FSTP-s (float store with pop) at the end. First | thought it was 
compiler anomaly (I’m collecting such cases just as someone do with butterflies), 
but it seems, it's handwritten assembler piece, in msvcrt.lib there is an object file 
with this function in it, and we can find this string in it: 
f:\dd\vctools\crt_bld\SELF X86\crt\prebuild\tran\i386\ftol2.asm — that 
was probably a path to the file on developer's computer where msvcrt.lib was built. 


So, bug, text editor-induced typo, or it was done by intent? The code working cor- 


rectly, anyway. 
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11.5.4 Summary 


Other compiler anomalies here in this book: 1.28.2 on page 395, 3.10.3 on page 616, 
3.18.7 on page 667, 1.26.7 on page 376, 1.18.4 on page 185, 1.28.5 on page 416. 


Such cases are demonstrated here in this book, to show that such compilers errors 
are possible and sometimes one should not to rack one's brain while thinking why 
did the compiler generate such strange code. 


11.6 Itanium 


Although almost failed, Intel Itanium (IA64) is a very interesting architecture. 


While OOE CPUs decides how to rearrange their instructions and execute them in 
parallel, EPIC’ was an attempt to shift these decisions to the compiler: to let it group 
the instructions at the compile stage. 


This resulted in notoriously complex compilers. 


Here is one sample of IA64 code: simple cryptographic algorithm from the Linux 
kernel: 


Listing 11.3: Linux kernel 3.2.0.4 


define TEA ROUNDS 32 
#define TEA DELTA 0x9e3779b9 


static void tea encrypt(struct crypto tfm *tfm, u8 *dst, const u8 *src) 
{ 

u32 y, Z, n, sum = 0; 

u32 k0, k1, k2, k3; 

struct tea ctx *ctx = crypto tfm ctx(tfm); 

const _ le32 *in = (const _ le32 *)src; 

. le32 *out = (. le32 *)dst; 


y = le32 to cpu(in[0]); 
z = le32 to cpu(in[1]); 
kO = ctx->KEY[0]; 
k1 = ctx->KEY[1]; 
k2 = ctx->KEY[2]; 
k3 = ctx->KEY[3]; 


n = TEA ROUNDS; 


while (n-- > 0) { 
sum += TEA DELTA; 
y += ((z << 4) + k0) ^ (z + sum) ^ ((z >> 5) + k1); 
z += ((y << 4) + k2) ^ (y + sum) ^ ((y >> 5) + k3); 
} 


out[0] = cpu to le32(y); 


7Explicitly Parallel Instruction Computing 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1262 


out[1] = 


cpu to le32(z); 


Here is how it was compiled: 


Listing 11.4: Linux Kernel 3.2.0.4 for Itanium 2 (McKinley) 


0090 | 
0090|08 80 80 41 
S KEY[2] 
0096|80 CO 82 00 
y KEY[0] 
009C|00 00 04 00 
00A0|09 18 70 41 
S KEY[1] 
00A6|FO 20 88 20 
00AC|44 06 01 84 
y KEY[3] 
00B0|08 98 00 20 
00B6|00 01 00 00 
y contain 
00BC|00 08 CA 00 
Ss register 
00C0|05 70 00 44 
9E FF FF FF 
00CC|92 F3 CE 6B 
00D0|08 00 00 00 
00D6|50 01 20 20 
00DC|FO 09 2A 00 
V is 32 
00E0|0A AO 00 06 
00E6|20 01 80 20 
00EC|00 00 04 00 
00FO0 | 
00FO | 
00F0|09 80 40 22 
Y =TEA_DELTA 
00F6|DO 71 54 26 
y kO 
OOFC|A3 70 68 52 
0100|03 FO 40 1C 
0106|BO E1 50 00 
010C|D3 F1 3C 80 
0110|0B C8 6C 34 
0116|F0 78 64 00 
011C|00 00 04 00 
0120|00 00 00 00 


0126|80 51 3C 
012C|F1 98 4C 
0130|0B B8 3C 
0136|A0 CO 48 
013C|00 00 04 
0140|0B 48 28 
0146|60 B9 24 


00 


42 


00 


28 


40 


00 


40 


OF 
40 


01 
29 


00 
40 


OF 
40 


21 


00 


21 


00 


10 
40 


10 
20 


00 
00 


10 
00 


20 


80 


20 


40 


20 
00 


00 
60 


20 
00 


20 
00 


tea_encrypt: 


adds r16 = 96, r32 


adds r8 = 88, r32 


nop.i 0 

adds r3 = 92, r32 
1d4 r15 = [r34], 4 
adds r32 = 100, r32;; 
1d4 r19 = [r16] 

mov r16 = r0 


mov.i r2 = ar.lc 


1d4 r14 = [r34] 


movl r17 = OxFFFFFFFF9E3779B9; ; 


nop.m 0 
1d4 r21 = [r8] 
mov.i ar.lc = 31 


1d4 r20 = [r3];; 
1d4 r18 = [r32] 
nop.i 0 

loc F0: 
add r16 - r16, r17 
shladd r29 = r14, 4, 
extr.u r28 = r14, 5, 
add r30 - r16, r14 
add r27 = r28, r20;; 
xor r26 - r29, r30;; 
xor r25 - r27, r26;; 
add r15 = r15, r25 
nop.i 0;; 
nop.m 0 
extr.u r24 = r15, 5, 
shladd r11 = r15, 4, 
add r23 = r15, r16;; 
add r10 - r24, r18 
nop.i 0;; 
xor r9 - r10, r11;; 
xor r22 = r23, r9 


r21 


275; 


27 
r19 


// 
// 


// 


// 
// 


// 
// 


// 
// 
// 


// 
// 


// 
// 


// 
// 


// 


// 


// 
// 


ptr to ctx-»7 


ptr to ctx-»7 


ptr to ctx-»7 


load z 


ptr to ctx-»7 


r19-k2 
rO always 7 


save lc 7 
load y 
TEA DELTA 


r21-k0 
TEA ROUNDS 7 


r20-k1 
r18-k3 


rl6-sum, r177 


rl4=y, r21-7 


r20=k1 


rl5-z 


r19=k2 


r18=k3 
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014C|00 00 04 00 nop.i 0;; 

0150|11 00 00 00 01 00 nop.m 0 

0156|E0 70 58 00 40 AO add r14 - r14, r22 

015C|A0 FF FF 48 br.cloop.sptk.few loc F0;; 

0160|09 20 3C 42 90 15 st4 [r33] = r15, 4 // store z 

0166|00 00 00 02 00 00 nop.m 0 

016C|20 08 AA 00 mov.i ar.lc = r2;; // restore lc 7 
y register 

0170|11 00 38 42 90 11 st4 [r33] = r14 // store y 

0176|00 00 00 02 00 80 nop.i 0 

017C|08 00 84 00 br.ret.sptk.many b0;; 


First of all, all IA64 instructions are grouped into 3-instruction bundles. 


Each bundle has a size of 16 bytes (128 bits) and consists of template code (5 bits) 
+ 3 instructions (41 bits for each). 


IDA shows the bundles as 6+6+4 bytes —you can easily spot the pattern. 


All 3 instructions from each bundle usually executes simultaneously, unless one of 
instructions has a "stop bit". 


Supposedly, Intel and HP engineers gathered statistics on most frequent instruction 
patterns and decided to bring bundle types (AKA "templates"): a bundle code defines 
the instruction types in the bundle. There are 12 of them. 


For example, the zeroth bundle type is MII, which implies the first instruction is 
Memory (load or store), the second and third ones are | (integer instructions). 


Another example is the bundle of type Ox1d: MFB: the first instruction is Memory 
(load or store), the second one is Float (FPU instruction), and the third is Branch 
(branch instruction). 


If the compiler cannot pick a suitable instruction for the relevant bundle slot, it may 
insert a NOP: you can see here the nop.i instructions (NOP at the place where the 
integer instruction might be) or nop.m (a memory instruction might be at this slot). 


NOPs are inserted automatically when one uses assembly language manually. 
And that is not all. Bundles are also grouped. 


Each bundle may have a "stop bit", so all the consecutive bundles with a terminating 
bundle which has the "stop bit" can be executed simultaneously. 


In practice, Itanium 2 can execute 2 bundles at once, resulting in the execution of 6 
instructions at once. 


So all instructions inside a bundle and a bundle group cannot interfere with each 
other (i.e., must not have data hazards). 


If they do, the results are to be undefined. 


Each stop bit is marked in assembly language as two semicolons (;;) after the in- 
struction. 


So, the instructions at [90-ac] may be executed simultaneously: they do not interfere. 
The next group is [bO-cc]. 
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We also see a stop bit at 10c. The next instruction at 110 has a stop bit too. 


This implies that these instructions must be executed isolated from all others (as in 
CISC). 


Indeed: the next instruction at 110 uses the result from the previous one (the value 
in register r26), so they cannot be executed at the same time. 


Apparently, the compiler was not able to find a better way to parallelize the instruc- 
tions, in other words, to load CPU as much as possible, hence too much stop bits and 
NOPs. 


Manual assembly programming is a tedious job as well: the programmer has to group 
the instructions manually. 


The programmer is still able to add stop bits to each instructions, but this will degrade 
the performance that Itanium was made for. 


An interesting examples of manual lA64 assembly code can be found in the Linux 
kernel's sources: 


http://lxr.free-electrons.com/source/arch/ia64/Llib/. 


Another introductory paper on Itanium assembly: [Mike Burrell, Writing Efficient Ita- 
nium 2 Assembly Code (2010)]5, [papasutra of haquebright, WRITING SHELLCODE 
FOR IA-64 (2001)P*. 


Another very interesting Itanium feature is the speculative execution and the NaT 
("not a thing") bit, somewhat resembling NaN numbers: 
MSDN. 


11.7 8086 memory model 


When dealing with 16-bit programs for MS-DOS or Win16 (8.8.3 on page 1078 or 
3.34.5 on page 827), we can see that the pointers consist of two 16-bit values. What 
do they mean? Oh yes, that is another weird MS-DOS and 8086 artifact. 


8086/8088 was a 16-bit CPU, but was able to address 20-bit address in RAM (thus 
being able to access 1MB of external memory). 


The external memory address space was divided between RAM (640KB max), ROM, 
windows for video memory, EMS cards, etc. 


Let's also recall that 8086/8088 was in fact an inheritor of the 8-bit 8080 CPU. 
The 8080 has a 16-bit memory space, i.e., it was able to address only 64KB. 


And probably because of reason of old software porting!?, 8086 can support many 
64KB windows simultaneously, placed within the 1MB address space. 


This is some kind of a toy-level virtualization. 


BAlso available as http://yurichev.com/mirrors/RE/itanium.pdf 
9Also available as http: //phrack.org/issues/57/5.html 
10The author is not 100% sure here 
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All 8086 registers are 16-bit, so to address more, special segment registers (CS, DS, 
ES, SS) were introduced. 


Each 20-bit pointer is calculated using the values from a segment register and an 
address register pair (e.g. DS:BX) as follows: 


real address = (segment register << 4) + address, register 


For example, the graphics (EGA, VGA?) video RAM window on old IBM PC-compatibles 
has a size of 64KB. 


To access it, a value of OxA000 has to be stored in one of the segment registers, e.g. 
into DS. 


Then DS:0 will address the first byte of video RAM and DS:0xFFFF — the last byte of 
RAM. 


The real address on the 20-bit address bus, however, will range from OxA0000 to 
OxAFFFF. 


The program may contain hard-coded addresses like 0x1234, but the OS may need 
to load the program at arbitrary addresses, so it recalculates the segment register 
values in a way that the program does not have to care where it's placed in the RAM. 


So, any pointer in the old MS-DOS environment in fact consisted of the segment 
address and the address inside segment, i.e., two 16-bit values. 20-bit was enough 
for that, though, but we needed to recalculate the addresses very often: passing 
more information on the stack seemed a better space/convenience balance. 


By the way, because of all this it was not possible to allocate a memory block larger 
than 64KB. 


The segment registers were reused at 80286 as selectors, serving a different func- 
tion. 


When the 80386 CPU and computers with bigger RAM were introduced, MS-DOS 
was still popular, so the DOS extenders emerged: these were in fact a step toward 
a "serious" OS, switching the CPU in protected mode and providing much better 
memory APIs for the programs which still needed to run under MS-DOS. 


Widely popular examples include DOS/AGW (the DOOM video game was compiled 
for it), Phar Lap, PMODE. 


By the way, the same way of addressing memory was used in the 16-bit line of 
Windows 3.x, before Win32. 


11.8 Basic blocks reordering 


11.8.1 Profile-guided optimization 


This optimization method can move some basic blocks to another section of the 
executable binary file. 


11Enhanced Graphics Adapter 
12Video Graphics Array 
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Obviously, there are parts of a function which are executed more frequently (e.g., 
loop bodies) and less often (e.g., error reporting code, exception handlers). 


The compiler adds instrumentation code into the executable, then the developer 
runs it with a lot of tests to collect statistics. 


Then the compiler, with the help of the statistics gathered, prepares final the exe- 
cutable file with all infrequently executed code moved into another section. 


As a result, all frequently executed function code is compacted, and that is very 
important for execution speed and cache usage. 


An example from Oracle RDBMS code, which was compiled with Intel C++: 


Listing 11.5: orageneric11.dll (win32) 


public skgfsync 
_skgfsync proc near 


; address 0x6030D86A 


db 66h 
nop 
push ebp 
mov ebp, esp 
mov edx, [ebp+0Ch] 
test edx, edx 
jz short loc 6030D884 
mov eax, [edx+30h] 
test eax, 400h 
jnz . VInfreq skgfsync ; write to log 
continue: 
mov eax, [ebp+8] 
mov edx, [ebp+10h] 
mov dword ptr [eax], 0 
lea eax, [edx+0Fh] 
and eax, OFFFFFFFCh 
mov ecx, [eax] 
cmp ecx, 45726963h 
jnz error ; exit with error 
mov esp, ebp 
pop ebp 
retn 
_skgfsync endp 


; address 0x60B953F0 


. VInfreq skgfsync: 


mov eax, [edx] 
test eax, eax 

jz continue 

mov ecx, [ebp+10h] 
push ecx 
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mov ecx, [ebp+8] 
push edx 
push ecx 


push offset ... ; 
"skgfsync(se=0x%x, ctx=0x%x, Lov=0x%x)\n" 
push dword ptr [edx+4] 


call dword ptr [eax] ; write to log 
add esp, 14h 
jmp continue 
error: 
mov edx, [ebp+8] 
mov dword ptr [edx], 69AAh ; 27050 "function called with 
invalid FIB/IOV structure" 
mov eax, [eax] 
mov [edx+4], eax 
mov dword ptr [edx+8], OFA4h ; 4004 
mov esp, ebp 
pop ebp 
retn 


; END OF FUNCTION CHUNK FOR _skgfsync 


The distance of addresses between these two code fragments is almost 9 MB. 


All infrequently executed code was placed at the end of the code section of the DLL 
file, among all function parts. 


This part of the function was marked by the Intel C++ compiler with the VInf req 
prefix. 


Here we see that a part of the function that writes to a log file (presumably in case 
of error or warning or something like that) which was probably not executed very 
often when Oracle’s developers gathered statistics (if it was executed at all). 


The writing to log basic block eventually returns the control flow to the “hot” part of 
the function. 


Another “infrequent” part is the basic block returning error code 27050. 


In Linux ELF files, all infrequently executed code is moved by Intel C++ into the 
separate text.unlikely section, leaving all “hot” code in the text.hot section. 


From a reverse engineer's perspective, this information may help to split the function 
into its core and error handling parts. 


11.9 My experience with Hex-Rays 2.2.0 
11.9.1 Bugs 


There are couple of bugs. 


First of all, Hex-Rays is getting lost when FPU instructions are interleaved (by com- 
piler codegenerator) with others. 


For example, this: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1268 


f proc near 
lea eax, [esp+4] 
fild dword ptr [eax] 
lea eax, [esp+8] 
fild dword ptr [eax] 
fabs 
fcompp 


fnstsw ax 
test ah, 1 


jz 101 
mov eax, 1 
retn 

101: 
mov eax, 2 
retn 

f endp 


...Will be correctly decompiled to: 


signed int cdecl f(signed int al, signed int a2) 


1 
signed int result; // eax@2 


if ( fabs((double)a2) >= (double)al ) 


result = 2; 
else 
result = 1; 


return result; 


But let’s comment one of the instructions at the end: 


101: 
;mov eax, 2 
retn 


...We getting an obvious bug: 


void cdecl f(char al, char a2) 


fabs((double)a2); 
} 


This is another bug: 


extrn f1:dword 
extrn f2:dword 
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f proc near 
fld dword ptr [esp+4] 
fadd dword ptr [esp+8] 
fst dword ptr [esp+12] 
fcomp | ds:const 100 
fld dword ptr [esp+16] ; comment this instruction 


and it will be OK 
fnstsw ax 


test ah, 1 


jnz short 101 

call f1 

retn 
101: 

call f2 

retn 
f endp 
const 100 dd 42C80000h ; 100.0 
Result: 
int  cdecl f(float al, float a2, float a3, float a4) 
1 


double v5; // st/7@l 
char v6; // c0@1 
int result; // eax@2 


v5 = a4; 
if ( v6 ) 

result = f2(v5); 
else 

result = f1(v5); 
return result; 


v6 variable has char type and if you'll try to compile this code, compiler will warn 
you about variable usage before assignment. 


Another bug: FPATAN instruction is correctly decompiled into atan2(), but arguments 
are swapped. 


11.9.2 Odd peculiarities 


Hex-Rays too often promotes 32-bit int to 64-bit one. Here is example: 


f proc near 
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mov eax, [esp+4] 
cdq 

xor eax, edx 
sub eax, edx 


; EAX=abs (al) 


sub eax, [esp+8] 
; EAX=EAX-a2 


; EAX at this point somehow gets promoted to 64-bit (RAX) 


cdq 
xor eax, edx 
sub eax, edx 


; EAX=abs(abs(al)-a2) 
retn 


f endp 


Result: 


int  cdecl f(int al, int a2) 
. int64 v2; // rax@l 
v2 = abs(al) - a2; 


return (HIDWORD(v2) ^ v2) - HIDWORD(v2); 
} 


Perhaps, this is result of CDQ instruction? I’m not sure. Anyway, whenever you see 


. int64 type in 32-bit code, pay attention. 


This is also weird: 


f proc near 
mov esi, [esp+4] 
lea ebx, [esi+10h] 
cmp esi, ebx 
jge short 100 
cmp esi, 1000 
jg short 100 
mov eax, 2 
retn 

100: 
mov eax, 1 
retn 

f endp 
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Result: 


signed int _ cdecl f(signed int al) 


{ 


Signed int result; // eax@3 


if ( _OFSUB (al, al + 16) ^ 1 && al <= 1000 ) 


result = 2; 
else 
result = 1; 


return result; 


The code is correct, but needs manual intervention. 
Sometimes, Hex-Rays doesn’t fold (or reduce) division by multiplication code: 


f proc near 
mov eax, [esp+4] 
mov edx, 2AAAAAABh 
imul edx 
mov eax, edx 
retn 

f endp 

Result: 


int  cdecl f(int al) 
{ 


} 


return (unsigned _int64) (715827883164 * al) >> 32; 


This can be folded (rewritten) manually. 


Many of these peculiarities can be solved by manual reordering of instructions, re- 
compiling assembly code, and then feeding it to Hex-Rays again. 


11.9.3 Silence 


extrn some func:dword 


f proc near 
mov ecx, [esp+4] 
mov eax, [esp+8] 
push eax 
call some_func 
add esp, 4 
; use ECX 
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mov eax, ecx 
retn 
f endp 
Result: 
int  cdecl f(int al, int a2) 
: int v2; // ecx@l 
some func(a2); 
return v2; 
} 


v2 variable (from ECX) is lost ...Yes, this code is incorrect (ECX value doesn’t saved 
during call to another function), but it would be good for Hex-Rays to give a warning. 


Another one: 


extrn some func:dword 


f proc near 
call some func 
jnz 101 
mov eax, 1 
retn 
101: 
mov eax, 2 
retn 
f endp 
Result: 
signed int f() 
1 
char v0; // zf@l 
Signed int result; // eax@2 
some_func(); 
if ( vO ) 
result - 1; 
else 
result = 2; 
return result; 
} 


Again, warning would be great. 
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Anyway, whenever you see variable of char type, or variable which is used with- 
out initialization, this is clear sign that something went wrong and needs manual 
intervention. 


11.9.4 Comma 


Comma in C/C++ has a bad fame, because it can lead to a confusing code. 
Quick quiz, what does this C/C++ function return? 


int f() 
1 


F 


return 1, 2; 


It's 2: when compiler encounters comma-expression, it generates code which exe- 
cutes all sub-expressions, and returns value of the last sub-expression. 


l've seen something like that in production code: 


if (cond) 

return global var-z123, 456; // 456 is returned 
else 

return global var-789, 321; // 321 is returned 


Apparently, programmer wanted to make code slightly shorter without additional 
curly brackets. In other words, comma allows to pack couple of expressions into 
one, without forming statement/code block inside of curly brackets. 


Comma in C/C++ is close to begin in Scheme/Racket: https://docs.racket- Lang. 
org/guide/begin.html. 


Perhaps, the only widely accepted usage of comma is in for() statements: 


char *s="hello, world"; 
for(int i-0; *s; s++, i++); 
// i = string length 


Both s++ and i++ are executed at each loop iteration. 
Read more: https://stackoverflow.com/q/52550. 


I’m writing all this because Hex-Rays produces (at least in my case) code which is 
rich with both commas and short-circuit expressions. For example, this is real output 
from Hex-Rays: 


if (a>=b || (c =a, (d[al - e) >> 2>f) ) 
{ 


This is correct, it compiles and works, and let god help you to understand it. Here is 
it rewritten: 
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if (cond1 || (comma expr, cond2)) 


{ 


Short-circuit is effective here: first cond1 is checked, if it's true, if() body is executed, 
the rest of if() expression is ignored completely. If cond1 is false, comma_expr is 
executed (in the previous example, a gets copied to c), then cond2 is checked. If 
cond2 is true, if() body gets executed, or not. In other words, if() body gets executed 
if cond1 is true or cond2 is true, but if the latter is true, comma expr is also executed. 


Now you can see why comma is so notorious. 


A word about short-circuit. A common beginner's misconception is that sub- 
conditions are checked in some unspecified order, which is not true. Ina | b | c 
expression, a, b and c gets evaluated in unspecified order, so that is why | | has also 
been added to C/C++, to apply short-circuit explicitly. 


11.9.5 Data types 


Data types is a problem for decompilers. 


Hex-Rays can be blind to arrays in local stack, if they weren't set correctly before 
decompilation. Same story about global arrays. 


Another problem is too big functions, where a single slot in local stack can be used 
by several variables across function's execution. It's not a rare case when a slot 
is used for int-variable, then for pointer, then for float-variable. Hex-Rays correctly 
decompiles it: it creates a variable with some type, then cast it to another type in 
various parts of functions. This problem has been solved by me by manual splitting 
big function into several smaller. Just make local variables as global ones, etc, etc. 
And don't forget about tests. 


11.9.6 Long and messed expressions 


Sometimes, during rewriting, you can end up with long and hard to understand ex- 
pressions in ¡f() constructs, like: 


if ( v38 && v30 <= 5 && v27 !- -1)) & ((! (v38 && v30 <= 5) && v27 != 2 


(! ( 
v -1) || (v24 >= 5 || v26)) && v25) 


Wolfram Mathematica can minimize some of them, using BooleanMinimize[] func- 
tion: 


In[1]:= BooleanMinimize[(! (v38 && v30 <= 5 && v27 != -1)) && v38 && v30 «-7 
G 5 && v25 == 0] 


Out[1]:= v38 && v25 == 0 && v27 == -1 && v30 <= 5 
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There is even better way, to find common subexpressions: 


In[2]:= Experimental OptimizeExpression[(! (v38 && v30 <= 5 && 
v27 !- -1)) && ((! (v38 && v30 <= 5) & 
v27 !- -1) || (v24 >= 5 || v26)) 68 v25] 


Out[2]= Experimental OptimizedExpression[ 
Block[fCompile' $1, Compile'$2), Compile'$1 = v30 <= 5; 
Compile'$2 = 
v27 !- -1; ! (v38 && Compile'$1 && 
Compile'$2) && ((! (v38 && Compile' $1) && Compile'$2) || 
v24 >= 5 || v26) && v25]] 


Mathematica has added two new variables: Compile'$1 and Compile’ $2, values 
of which are to be used several times in expression. So we can add two additional 
variables. 


11.9.7 De Morgan's laws and decompilation 


Sometimes a compiler's optimizer can use De Morgan's laws to make code shorter/- 
faster. 


For example, this: 


void f(int a, int b, int c, int d) 


1 
if (a>0 && b>0) 
printf ("both a and b are positive\n"); 
else if (c>0 && d>0) 
printf ("both c and d are positive\n"); 
else 
printf ("something else\n"); 
F 


... looks pretty innocent, when compiled by optimizing GCC 5.4.0 x64: 


; int fastcall f(int a, int b, int c, int d) 


public f 
f proc near 
test edi, edi 
jte short loc 8 
test esi, esi 
jg short loc 30 
loc 8: 
test edx, edx 
jte short loc 20 
test ecx, ecx 
jte short loc 20 
mov edi, offset s ; "both c and d are positive" 
jmp puts 
loc 20: 
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mov edi, offset aSomethingElse ; "something else" 
jmp puts 
loc 30: 
mov edi, offset aAAndBPositive ; "both a and b are 
positive" 
loc 35: 
jmp puts 
f endp 


. also looks innocent, but Hex-Rays 2.2.0 cannot clearly see that both AND opera- 
tions were actually used in the source code: 


int  fastcall f(int a, int b, int c, int d) 
1 


int result; 


if(a>066b>0) 
1 


} 
else if ( c <= 0 || d <= 0 ) 


result = puts("both a and b are positive"); 


result = puts("something else"); 


} 

else 

{ 

result = puts("both c and d are positive"); 

} 

return result; 
} 
The c <= 0 || d <= 0 expression is inversion of c»0 && d>0 since AU B = An B 
and An B — Au B, in other words, !(cond1 || cond2) == !cond1 && !cond2 and 
! (cond1 && cond2) == !cond1 || !cond2. 


These rules are worth to be kept in mind, since this compiler optimization is used 
heavily almost everywhere. 


Sometimes it's good idea to invert a condition, in order to understand a code better. 
This is a piece of a real code decompiled by Hex-Rays: 


for (int i20; i<12; i++) 


1 
if (v1[i-12] != 0.0 || v1[i] != 0.0) 
1 
v108=min(v108, (float)vO[i*24 -2]); 
v113=max(v113, (float)v0[i*24]); 
un 
} 


. it can be rewritten like: 
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for (int i20; i<12; i++) 


1 
if (v1[i-12] == 0.0 && v1[i] == 0.0) 
continue; 
v108=min(v108, (float)vO[i*24 -2]); 
v113=max(v113, (float)v0[i*24]); 
} 


Which is better? | don’t know yet, but for better understanding, it’s good to take a 
look on both versions. 


11.9.8 My plan 


* Split big functions (and don't forget about tests). Sometimes it's very helpful 
to form new functions out of big loop bodies. 


* Check/set data type of variables, arrays, etc. 


* If you see odd result, dangling variable (which used before initialization), try to 
swap instructions manually, recompile it and feed to Hex-Rays again. 


11.9.9 Summary 


Nevertheless, quality of Hex-Rays 2.2.0 is very, very good. It makes life way easier. 


11.10 Cyclomatic complexity 

The term is used to measure complexity of a function. Complex functions are usually 
evil, because they are hard to maintain, hard to test, etc. 

There are several heuristics to measure it. 

For example, we can find in Linux kernel coding style??: 


Now, some people will claim that having 8-character indentations 
makes the code move too far to the right, and makes it hard to read 
on a 80-character terminal screen. The answer to that is that if you 
need more than 3 levels of indentation, you're screwed anyway, and 
should fix your program. 


Functions should be short and sweet, and do just one thing. They 
should fit on one or two screenfuls of text (the ISO/ANSI screen size is 
80x24, as we all know), and do one thing and do that well. 

The maximum length of a function is inversely proportional to the 
complexity and indentation level of that function. So, if you have a 


I3https://www.kernel.org/doc/html/v4.10/process/coding-style.html 
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conceptually simple function that is just one long (but simple) case- 
statement, where you have to do lots of small things for a lot of differ- 
ent cases, it's OK to have a longer function. 

However, if you have a complex function, and you suspect that a 
less-than-gifted first-year high-school student might not even under- 
stand what the function is all about, you should adhere to the max- 
imum limits all the more closely. Use helper functions with descrip- 
tive names (you can ask the compiler to in-line them if you think it's 
performance-critical, and it will probably do a better job of it than you 
would have done). 

Another measure of the function is the number of local variables. 
They shouldn't exceed 5-10, or you're doing something wrong. Re- 
think the function, and split it into smaller pieces. A human brain can 
generally easily keep track of about 7 different things, anything more 
and it gets confused. You know you're brilliant, but maybe you'd like 
to understand what you did 2 weeks from now. 


In JPL Institutional Coding Standard for the C Programming Language !^: 


Functions should be no longer than 60 lines of text and define no 
more than 6 parameters. 

A function should not be longer than what can be printed on a single 
sheet of paper in a standard reference format with one line per state- 
ment and one line per declaration. Typically, this means no more than 
about 60 lines of code per function. Long lists of function parameters 
similarly compromise code clarity and should be avoided. 

Each function should be a logical unit in the code that is under- 
standable and verifiable as a unit. It is much harder to understand a 
logical unit that spans multiple screens on a computer display or mul- 
tiple pages when printed. Excessively long functions are often a sign 
of poorly structured code. 


Now let's back to cyclomatic complexity. 


Mhttps://yurichev.com/mirrors/C/JPL Coding Standard C.pdf 
15Basic Block 


Without diving deep into graph theory: there are basic blocks and links between 
them. For example, this is how IDA shows BB*%s and links (as arrows). Just click 
space and you'll see this: 1.18 on page 115. Each BB is also called vertex or node 
in graph theory. Each link - edge. 


There are at least two popular ways to calculate cyclomatic complexity: 1) edges - 
nodes + 2 2) edges - nodes + number of exits (RET instructions) 


As of IDA example below, there are 4 BBs, so that is 4 nodes. But there are also 4 
links and 1 return instruction. By 1st rule, this is 2, by the second: 1. 


The bigger the number, the more complex your function and things go from bad to 
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Worse. As you can see, additional exit (return instructions) make things even worse, 
as well as additional links between nodes (including additional goto's). 


| wrote the simple IDAPython script (https: //beginners.re/paywall/REAB- source/ 
current-tree//other/cyclomatic/cyclomatic.py) to measure it. Here is result 
for Linux kernel 4.11 (most complex functions in it): 


1829c0 do check edges-937 nodes=574 rets=1 E-N+2=365 E-N+rets=364 

2effe0 ext4 fill super edges=862 nodes=568 rets=1 E-N+2=296 E-N+rets=295 

5d92e0 wm5110 readable register edges=661 nodes=369 rets=2 E-N+2=294 E-N*7 
y rets-294 

277650 do blockdev direct IO edges-771 nodes=507 rets-1 E-N+2=266 E-N+retsv 
V =265 

10f7c0 load module edges=711 nodes-465 rets-1 E-N+2=248 E-N+rets=247 

787730 dev ethtool edges=559 nodes-315 rets-1 E-N+2=246 E-N+rets=245 

84e440 do ipv6 setsockopt edges-468 nodes-237 rets-1 E-N+2=233 E-N+rets=232 

72c3c0 mmc init card edges=593 nodes-365 rets-1 E-N+2=230 E-N+rets=229 


( Full list: https://beginners.re/paywall/RE4B-source/current-tree//other/ 
cyclomatic/linux 4.11 sorted.txt ) 


This is source code of some of them: do check(), ext4 fill super(), do blockdev direct IO(), 
do jit(). 


Most complex functions in Windows 7 ntoskrnl.exe file: 


140569400 sub 140569400 edges-3070 nodes-1889 rets=1 E-N+2=1183 E-N+rets/ 
S =1182 

14007c640 MmAccessFault edges=2256 nodes=1424 rets=1 E-N+2=834 E-N+rets=833 

1401a0410 FsRtlMdlReadCompleteDevEx edges=1241 nodes-752 rets=1 E-N+2=491 Ev 
V -N+rets=490 

14008c190 MmProbeAndLockPages edges=983 nodes=623 rets=1 E-N+2=362 E-N+rets/ 
V =361 

14037fd10 ExpQuerySystemInformation edges=995 nodes=671 rets-1 E-N+2=326 E- 2 
V N+rets=325 

140197260 MmProbeAndLockSelectedPages edges=875 nodes=551 rets-1 E-N+2=326 7 
S E-N+rets=325 

140362a50 NtSetInformationProcess edges=880 nodes=586 rets=1 E-N+2=296 E-N+/ 
V rets=295 


( Full list: https://beginners. re/paywall/RE4B- source/current-tree//other/ 
cyclomatic/win7 ntoskrnl sorted.txt ) 


From a bug hunter’s standpoint, complex functions are prone to have bugs, so an 
attention should be paid to them. 


Read more about it: https://en.wikipedia.org/wiki/Cyclomatic complexity, 
http://wiki.c2.com/?CyclomaticComplexityMetric. 


Measuring cyclomatic complexity in MSVS (C#): https://blogs.msdn.microsoft. 
com/zainnab/2011/05/17/code-metrics-cyclomatic- complexity/. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 


1280 
Couple of other Python scripts for measuring cyclomatic complexity in IDA: http:// 
www.openrce.org/articles/full view/11, https: //github.com/mxmssh/IDAmetrics 
(incl. other metrics). 


GCC plugin: https://github.com/ephox-gcc-plugins/cyclomatic complexity. 
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Books/blogs worth reading 


12. 


1 Books and other materials 


12.1.1 Reverse Engineering 


Eldad Eilam, Reversing: Secrets of Reverse Engineering, (2005) 


Bruce Dang, Alexandre Gazet, Elias Bachaalany, Sebastien Josse, Practical Re- 
verse Engineering: x86, x64, ARM, Windows Kernel, Reversing Tools, and Ob- 
fuscation, (2014) 


Michael Sikorski, Andrew Honig, Practical Malware Analysis: The Hands-On Guide 
to Dissecting Malicious Software, (2012) 


Chris Eagle, IDA Pro Book, (2011) 


Reginald Wong, Mastering Reverse Engineering: Re-engineer your ethical hack- 
ing skills, (2018) 


(Outdated, but still interesting) Pavol Cerven, Crackproof Your Software: Protect Your 
Software Against Crackers, (2002). 


Also, Kris Kaspersky's books. 


12.1.2 Windows 


Mark Russinovich, Microsoft Windows Internals 
Peter Ferrie - The "Ultimate" Anti-Debugging Reference! 


Blogs: 


Microsoft: Raymond Chen 


nynaeve.net 


lhttp://pferrie.host22.com/papers/antidebug.pdf 
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12.1.3 C/C++ 


* Brian W. Kernighan, Dennis M. Ritchie, The C Programming Language, 2ed, 
(1988) 


* ISO/IEC 9899:TC3 (C C99 standard), (2007)? 

* Bjarne Stroustrup, The C++ Programming Language, 4th Edition, (2013) 
* C++11 standard? 

* Agner Fog, Optimizing software in C++ (2015)^ 

* Marshall Cline, C++ FAQ? 


* Dennis Yurichev, C/C++ programming language notes 


JPL Institutional Coding Standard for the C Programming Language’ 


12.1.4 x86 / x86-64 


* Intel manuals? 

* AMD manuals? 

e Agner Fog, The microarchitecture of Intel, AMD and VIA CPUs, (2016)? 

* Agner Fog, Calling conventions (2015) 

Intel® 64 and IA-32 Architectures Optimization Reference Manual, (2014) 


* Software Optimization Guide for AMD Family 16h Processors, (2013) 
Somewhat outdated, but still interesting to read: 


Michael Abrash, Graphics Programming Black Book, 1997?? (he is known for his work 
on low-level optimization for such projects as Windows NT 3.1 and id Quake). 


12.1.5 ARM 


* ARM manuals? 
* ARM(R) Architecture Reference Manual, ARMv7-A and ARMv7-R edition, (2012) 


2Also available as http: //www.open-std.org/jtc1/sc22/WG14/www/docs/n1256.pdf 
3Also available as http: //www.open- std.org/jtc1/sc22/wg21/docs/papers/2013/n3690 . pdf. 
^Also available as http://agner.org/optimize/optimizing cpp.pdf. 
5Also available as http://www. parashift.com/c++- faq-lite/index.html 
also available as http: //yurichev.com/C-book.html 
7Also available as https: //yurichev.com/mirrors/C/JPL_ Coding Standard C.pdf 
8Also available as http://www.intel.com/content/www/us/en/processors/ 
architectures-software-developer-manuals.html 
9Also available as http: //developer.amd.com/resources/developer-guides-manuals/ 
10Also available as http://agner.org/optimize/microarchitecture.pdf 
11Also available as http://www.agner.org/optimize/calling conventions.pdf 
12Also available as https: //github.com/jagregory/abrash-black- book 
l3Also available as http://infocenter.arm.com/help/index. jsp?topic=/com.arm.doc.subset. 
architecture. reference/index. html 
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* [ARM Architecture Reference Manual, ARMv8, for ARMv8-A architecture profile, 
(2013)]4 


* Advanced RISC Machines Ltd, The ARM Cookbook, (1994.)15 


12.1.6 Assembly language 


Richard Blum — Professional Assembly Language. 


12.1.7 Java 


[Tim Lindholm, Frank Yellin, Gilad Bracha, Alex Buckley, The Java(R) Virtual Machine 
Specification / Java SE 7 Edition] **. 


12.1.8 UNIX 
Eric S. Raymond, The Art of UNIX Programming, (2003) 


12.1.9 Programming in general 


* Brian W. Kernighan, Rob Pike, Practice of Programming, (1999) 


* Henry S. Warren, Hacker's Delight, (2002). Some people say tricks and hacks 
from the book are not relevant today because they were good only for RISC 
CPUs, where branching instructions are expensive. Nevertheless, these can 
help immensely to understand boolean algebra and what all the mathematics 
near it. 


12.1.10 Cryptography 
* Bruce Schneier, Applied Cryptography, (John Wiley & Sons, 1994) 
e (Free) Ivh, Crypto 101*” 
e (Free) Dan Boneh, Victor Shoup, A Graduate Course in Applied Cryptography??. 


12.1.11 Something even easier 


For those who find this book too hard and technical, this is even gentler introduc- 
tion to low-level internals of computing devices: "Code: The Hidden Language of 
Computer Hardware and Software" by Charles Petzold. 


Another is a comic book (from 1983) for kids!?, devoted to 6502 and Z80 CPUs. 


lMAlso available as http://yurichev.com/mirrors/ARMv8-A Architecture Reference Manual _ 
(Issue A.a).pdf 

15Also available as https: //yurichev.com/ref /ARM%20Cookbook%20 (1994) / 

l6Also available as https://docs.oracle.com/javase/specs/jvms/se7/jvms7.pdf; http://docs. 
oracle.com/javase/specs/jvms/se7/html/ 

l17Also available as https://www.crypto101.io/ 

18A|so available as https://crypto.stanford.edu/-dabo/cryptobook/ 

19https://yurichev.com/mirrors/machine-code-for-beginners.pdf 
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Communities 


There are two excellent RE!-related subreddits on reddit.com: 
reddit.com/r/ReverseEngineering/ and reddit.com/r/remath (on the topics for the in- 
tersection of RE and mathematics). 


There is also a RE part of the Stack Exchange website: 
reverseengineering.stackexchange.com. 


On IRC there are ##re and ##asm channels on Libera. 


lReverse Engineering 
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Afterword 
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13.1 Questions? 


Do not hesitate to mail any questions to the author: 

my emails. Do you have any suggestion on new content for to the book? Please do 
not hesitate to send any corrections (including grammar (you see how horrible my 
English is?)), etc. 


The author is working on the book a lot, so the page and listing numbers, etc., are 
changing very rapidly. Please do not refer to page and listing numbers in your emails 
to me. There is a much simpler method: make a screenshot of the page, in a graphics 
editor underline the place where you see the error, and send it to the author. He'll 
fix it much faster. And if you familiar with git and ATEX you can fix the error right in 
the source code: 


https://beginners.re/src/. 


Do not worry to bother me while writing me about any petty mistakes you found, 
even if you are not very confident. I’m writing for beginners, after all, so beginners’ 
opinions and comments are crucial for my job. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
emails. Thanks! 
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.1 x86 


.1.1 Terminology 
Common for 16-bit (8086/80286), 32-bit (80386, etc.), 64-bit. 


byte 8-bit. The DB assembly directive is used for defining variables and arrays of 
bytes. Bytes are passed in the 8-bit part of registers: AL/BL/CL/DL/AH/BH/CH/DH/SIL/DIL/R*L. 


word 16-bit. DW assembly directive —"—. Words are passed in the 16-bit part of 
the registers: 
AX/BX/CX/DX/SI/DI/R*W. 


double word (“dword”) 32-bit. DD assembly directive —"—. Double words are 
passed in registers (x86) or in the 32-bit part of registers (x64). In 16-bit code, 
double words are passed in 16-bit register pairs. 


quad word (“qword”) 64-bit. DQ assembly directive —"—. In 32-bit environment, 
quad words are passed in 32-bit register pairs. 


tbyte (10 bytes) 80-bit or 10 bytes (used for IEEE 754 FPU registers). 
paragraph (16 bytes)—term was popular in MS-DOS environment. 


Data types of the same width (BYTE, WORD, DWORD) are also the same in Windows 
API. 


.1.2 General purpose registers 
It is possible to access many registers by byte or 16-bit word parts. 


It is all inheritance from older Intel CPUs (up to the 8-bit 8080) still supported for 
backward compatibility. Older 8-bit CPUs (8080) had 16-bit registers divided by two. 


Programs written for 8080 could access the low byte part of 16-bit registers, high 
byte part or the whole 16-bit register. 


Perhaps, this feature was left in 8086 as a helper for easier porting. 

This feature is usually not present in RISC CPUs. 

Registers prefixed with R- appeared in x86-64, and those prefixed with E-—in 80386. 
Thus, R-registers are 64-bit, and E-registers—32-bit. 

8 more GPR's were added in x86-86: R8-R15. 


N.B.: In the Intel manuals the byte parts of these registers are prefixed by L, e.g.: 
R8L, but IDA names these registers by adding the B suffix, e.g.: R8B. 
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RAX/EAX/AX/AL 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RAX*64 


EAX 


AX 
AH | AL 


AKA accumulator. The result of a function is usually returned via this register. 


RBX/EBX/BX/BL 
Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RBX*e4 
EBX 

BX 

BH | BL 
RCX/ECX/CX/CL 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RCX*64 


ECX 


CX 
CH | CL 


AKA counter: in this role it is used in REP prefixed instructions and also in shift 
instructions (SHL/SHR/RXL/RxR). 


RDX/EDX/DX/DL 
Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RDX*e4 
EDX 

DX 

DH | DL 
RSI/ESI/SI/SIL 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
Espe? 


ESI 


SI 
TES 
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RDI/EDI/DI/DIL 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RDIX64 


EDI 


DI 
DIL*®4 


AKA “destination index”. Used as a pointer to the destination in the instructions REP 
MOVSx, REP STOSx. 


R8/R8D/R8W/R8L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R8 


R8D 


R8W 
R8L 


R9/R9D/R9W/R9L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R9 


R9D 


ROW 
ROL 


R10/R10D/R10W/R10L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R10 


R10D 


R10W 
R10L 


R11/R11D/R11W/R11L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R11 


R11D 


R11W 
R11L 
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R12/R12D/R12W/R12L 


Byte number: 
7th | oth | 5th | 4th | 3rd | 2nd | 1st | Oth 
R12 


R12D 


R12W 
R12L 


R13/R13D/R13W/R13L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R13 


R13D 


R13W 
R13L 


R14/R14D/R14W/R14L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R14 


R14D 


R14W 
R14L 


R15/R15D/R15W/R15L 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
R15 


R15D 


R15W 
R15L 


RSP/ESP/SP/SPL 


Byte number: 
7th | oth | 5th | 4th | 3rd | 2nd | 1st | Oth 
RSP 


ESP 


SP 
SPL 


AKA stack pointer. Usually points to the current stack except in those cases when it 
is not yet initialized. 
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RBP/EBP/BP/BPL 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RBP 


EBP 


BP 
BPL 


AKA frame pointer. Usually used for local variables and accessing the arguments of 
the function. More about it: (1.12.1 on page 89). 


RIP/EIP/IP 


Byte number: 
7th | 6th | 5th | 4th | 3rd | 2nd | 1st | Oth 
RIPX94 


EIP 


AKA "instruction pointer" ?. Usually always points to the instruction to be executed 
right now. Cannot be modified, however, it is possible to do this (which is equivalent): 


MOV EAX, 
JMP EAX 


Or: 


PUSH value 
RET 


CS/DS/ES/SS/FS/GS 


16-bit registers containing code selector (CS), data selector (DS), stack selector (SS). 


FS in win32 points to TLS, GS took this role in Linux. It is made so for faster ac- 
cess to the TLS and other structures like the TIB. 
In the past, these registers were used as segment registers (11.7 on page 1264). 


Flags register 


AKA EFLAGS. 


?Sometimes also called "program counter" 
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Bit (mask) Abbreviation (meaning) Description 
0 (1) CF (Carry) The CLC/STC/CMC instructions are used 
for setting/resetting/toggling this flag 
2 (4) PF (Parity) (1.25.7 on page 293). 
4 (0x10) AF (Adjust) Exist solely for work with BCD-numbers 
6 (0x40) ZF (Zero) Setting to O 
if the last operation's result is equal to O. 
7 (0x80) SF (Sign) 
8 (0x100) TF (Trap) Used for debugging. 


If turned on, an exception is to be 
generated after each instruction's execution. 


9 (0x200) IF (Interrupt enable) Are interrupts enabled. 
The CLI/STI instructions are used 
for setting/resetting the flag 


10 (0x400) DF (Direction) A direction is set for the 

REP MOVSx/CMPSx/LODSx/SCASx instructions. 
The CLD/STD instructions are used 

for setting/resetting the flag 

See also: 3.26 on page 794. 


11 (0x800) OF (Overflow) Overflow flag 

12, 13 (0x3000) | IOPL (I/O privilege level)96 

14 (0x4000) NT (Nested task)"75* 

16 (0x10000) RF (Resume)??5 Used for debugging. 


The CPU ignores the hardware 
breakpoint in DRx if the flag is set. 


17 (0x20000) VM (Virtual 8086 mode)?" 


18 (0x40000) AC (Alignment check) "s5 


19 (0x80000) VIF (Virtual interrupt) ^95 


O a] A] 


20 (0x100000) VIP (Virtual interrupt pending)^95 


21 (0x200000) ID (Identification)'?8e 


All the rest flags are reserved. 


.1.3 FPU registers 


8 80-bit registers working as a stack: ST(0)-ST(7). N.B.: IDA calls ST(O) as just ST. 
Numbers are stored in the IEEE 754 format. 


long double value format: 


79 78 64 63 62 0 


S exponent | mantissa or fraction 


( S — sign, | — integer part ) 


Control Word 
Register controlling the behavior of the FPU. 
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Bit Abbreviation (meaning) Description 
0 IM (Invalid operation Mask) 
1 DM (Denormalized operand Mask) 
2 ZM (Zero divide Mask) 
3 OM (Overflow Mask) 
4 UM (Underflow Mask) 
5 PM (Precision Mask) 
7 IEM (Interrupt Enable Mask) Exceptions enabling, 1 by default (disabled) 
8,9 PC (Precision Control) 
00 — 24 bits (REAL4) 
10 — 53 bits (REAL8) 
11 — 64 bits (REAL10) 
10,11 | RC (Rounding Control) 
00 — (by default) round to nearest 
01 — round toward -o0 
10 — round toward +00 
11 — round toward O 
12 IC (Infinity Control) O — (by default) treat +00 and -œ as unsigned 
1 — respect both +o and —oo 


The PM, UM, OM, ZM, DM, IM flags define if to generate exception in the case of a 


corresponding error. 


Status Word 


Read-only register. 


Bit Abbreviation (meaning) | Description 
15 B (Busy) Is FPU do something (1) or results are ready (0) 
14 C3 
13, 12, 11 | TOP points to the currently zeroth register 
10 C2 
9 C1 
CO 
7 IR (Interrupt Request) 
6 SF (Stack Fault) 
5 P (Precision) 
4 U (Underflow) 
3 O (Overflow) 
2 Z (Zero) 
1 D (Denormalized) 
0 | (Invalid operation) 


The SF, P, U, O, Z, D, I bits signal about exceptions. 
About the C3, C2, C1, CO you can read more here: (1.25.7 on page 292). 
N.B.: When ST(x) is used, the FPU adds x to TOP (by modulo 8) and that is how it 


gets the internal register's number. 
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Tag Word 
The register has current information about the usage of numbers registers. 
Bit Abbreviation (meaning) 
15, 14 | Tag(7) 
13, 12 | Tag(6) 
11, 10 | Tag(5) 
9,8 Tag(4) 
7,6 Tag(3) 
5,4 Tag(2) 
3,2 Tag(1) 
1,0 Tag(0) 


Each tag contains information about a physical FPU register (R(x)), not logical (ST(x)). 
For each tag: 

* 00 — The register contains a non-zero value 

* 01 — The register contains O 

* 10 — The register contains a special value (NAN?, oo, or denormal) 


* 11 — The register is empty 


.1.4 SIMD registers 
MMX registers 
8 64-bit registers: MMO..MM7. 


SSE and AVX registers 


SSE: 8 128-bit registers: XMMO..XMM7. In the x86-64 8 more registers were added: 
XMM8..XMM15. 


AVX is the extension of all these registers to 256 bits. 


.1.5 Debugging registers 
Used for hardware breakpoints control. 
* DRO — address of breakpoint #1 
+ DR1 — address of breakpoint #2 
* DR2 — address of breakpoint #3 
* DR3 — address of breakpoint #4 
* DR6 — a cause of break is reflected here 


* DR7 — breakpoint types are set here 


3Not a Number 
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DR6 
Bit (mask) Description 
O (1) BO — breakpoint #1 has been triggered 
1 (2) B1 — breakpoint #2 has been triggered 
2 (4) B2 — breakpoint #3 has been triggered 
3 (8) B3 — breakpoint #4 has been triggered 


13 (0x2000) | BD — modification attempt of one of the DRx registers. 

may be raised if GD is enabled 

14 (0x4000) | BS — single step breakpoint (TF flag has been set in EFLAGS). 
Highest priority. Other bits may also be set. 

15 (0x8000) | BT (task switch flag) 


N.B. A single step breakpoint is a breakpoint which occurs after each instruction. It 
can be enabled by setting TF in EFLAGS (.1.2 on page 1292). 


DR7 


Breakpoint types are set here. 


Bit (mask) Description 

0 (1) LO — enable breakpoint £1 for the current task 
1 (2) GO — enable breakpoint £1 for all tasks 

2 (4) L1 — enable breakpoint #2 for the current task 
3 (8) G1 — enable breakpoint £2 for all tasks 

4 (0x10) L2 — enable breakpoint #3 for the current task 
5 (0x20) G2 — enable breakpoint £3 for all tasks 

6 (0x40) L3 — enable breakpoint £4 for the current task 
7 (0x80) G3 — enable breakpoint £4 for all tasks 

8 (0x100) LE — not supported since P6 

9 (0x200) GE — not supported since P6 

13 (0x2000) GD — exception is to be raised if any MOV instruction 


tries to modify one of the DRx registers 


16,17 (0x30000) breakpoint #1: R/W — type 
18,19 (0xC0000) breakpoint #1: LEN — length 
20,21 (0x300000) breakpoint #2: R/W — type 
22,23 (0xC00000) breakpoint #2: LEN — length 
24,25 (0x3000000) breakpoint #3: R/W — type 
26,27 (0xC000000) breakpoint #3: LEN — length 
28,29 (0x30000000) | breakpoint #4: R/W — type 
30,31 (0xC0000000) | breakpoint #4: LEN — length 


The breakpoint type is to be set as follows (R/W): 


* 00— instruction execution 


* 01 — data writes 


* 10 — I/O reads or writes (not available in user-mode) 


* 11 — on data reads or writes 
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N.B.: breakpoint type for data reads is absent, indeed. 


Breakpoint length is to be set as follows (LEN): 
* 00 — one-byte 
* 01 — two-byte 
* 10 — undefined for 32-bit mode, eight-byte in 64-bit mode 
* 11 — four-byte 


.1.6 Instructions 


Instructions marked as (M) are not usually generated by the compiler: if you see one 
of them, it is probably a hand-written piece of assembly code, or a compiler intrinsic 
(11.4 on page 1258). 


Only the most frequently used instructions are listed here. You can read 12.1.4 on 
page 1282 for a full documentation. 


Do you have to know all instruction’s opcodes by heart? No, only those which are 
used for code patching (11.2.1 on page 1256). All the rest of the opcodes don’t need 
to be memorized. 


Prefixes 


LOCK forces CPU to make exclusive access to the RAM in multiprocessor environ- 
ment. For the sake of simplification, it can be said that when an instruction with 
this prefix is executed, all other CPUs in a multiprocessor system are stopped. 
Most often it is used for critical sections, semaphores, mutexes. Commonly 
used with ADD, AND, BTR, BTS, CMPXCHG, OR, XADD, XOR. You can read more 
about critical sections here (6.5.4 on page 1002). 


REP is used with the MOVSx and STOSx instructions: execute the instruction in 
a loop, the counter is located in the CX/ECX/RCX register. For a detailed de- 
scription, read more about the MOVSx (.1.6 on page 1300) and STOSx (.1.6 on 
page 1303) instructions. 


The instructions prefixed by REP are sensitive to the DF flag, which is used to 
set the direction. 


REPE/REPNE (AKA REPZ/REPNZ) used with CMPSx and SCASx instructions: execute 
the last instruction in a loop, the count is set in the CX/ECX/RCX register. It 
terminates prematurely if ZF is O (REPE) or if ZF is 1 (REPNE). 


For a detailed description, you can read more about the CMPSx (.1.6 on page 1304) 
and SCASx (.1.6 on page 1302) instructions. 


Instructions prefixed by REPE/REPNE are sensitive to the DF flag, which is used 
to set the direction. 
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Most frequently used instructions 


These can be memorized in the first place. 


ADC (add with carry) add values, increment the result if the CF flag is set. ADC is 
often used for the addition of large values, for example, to add two 64-bit values 
in a 32-bit environment using two ADD and ADC instructions. For example: 


; work with 64-bit values: add vall to val2. 

; .lo means lowest 32 bits, .hi means highest. 

ADD vall.lo, val2.lo 

ADC vall.hi, val2.hi ; use CF that was set or cleared at the previous 
instruction 


One more example: 1.34 on page 497. 
ADD add two values 
AND logical "and" 


CALL call another function: 
PUSH address after CALL instruction; JMP label 


CMP compare values and set flags, the same as SUB but without writing the result 


DEC decrement. Unlike other arithmetic instructions, DEC doesn't modify CF flag. 


IMUL signed multiply IMUL often used instead of MUL, read more about it: 11.1 on 
page 1255. 


INC increment. Unlike other arithmetic instructions, INC doesn't modify CF flag. 
JCXZ, JECXZ, JRCXZ (M) jump if CX/ECX/RCX=0 

JMP jump to another address. The opcode has a jump offset. 

Jcc (where cc — condition code) 


A lot of these instructions have synonyms (denoted with AKA), this was done 
for convenience. Synonymous instructions are translated into the same opcode. 
The opcode has a jump offset. 


JAE AKA JNC: jump if above or equal (unsigned): CF=0 
JA AKA JNBE: jump if greater (unsigned): CF=0 and ZF=0 
JBE jump if lesser or equal (unsigned): CF=1 or ZF=1 

JB AKA JC: jump if below (unsigned): CF=1 

JC AKA JB: jump if CF=1 

JE AKA JZ: jump if equal or zero: ZF=1 

JGE jump if greater or equal (signed): SF=OF 

JG jump if greater (signed): ZF=0 and SF=OF 

JLE jump if lesser or equal (signed): ZF=1 or SF+OF 
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JL jump if lesser (signed): SF+OF 
JNAE AKA JC: jump if not above or equal (unsigned) CF=1 
JNA jump if not above (unsigned) CF=1 and ZF=1 
JNBE jump if not below or equal (unsigned): CF=0 and ZF=0 
JNB AKA JNC: jump if not below (unsigned): CF=0 
JNC AKA JAE: jump CF=0 synonymous to JNB. 
JNE AKA JNZ: jump if not equal or not zero: ZF=0 
JNGE jump if not greater or equal (signed): SF+OF 
JNG jump if not greater (signed): ZF=1 or SF+OF 
JNLE jump if not lesser (signed): ZF=0 and SF=OF 
JNL jump if not lesser (signed): SF=OF 
JNO jump if not overflow: OF=0 
JNS jump if SF flag is cleared 
JNZ AKA JNE: jump if not equal or not zero: ZF=0 
JO jump if overflow: OF=1 
JPO jump if PF flag is cleared (Jump Parity Odd) 
JP AKA JPE: jump if PF flag is set 
JS jump if SF flag is set 
JZ AKA JE: jump if equal or zero: ZF=1 
LAHF copy some flag bits to AH: 


7 6 4 2 0 


SFZF AF PF CH 


This instruction is often used in FPU-related code. 


LEAVE equivalent of the MOV ESP, EBP and POP EBP instruction pair — in other 
words, this instruction sets the stack pointer (ESP) back and restores the EBP 
register to its initial state. 


LEA (Load Effective Address) form an address 


This instruction was intended not for summing values and multiplication but 
for forming an address, e.g., for calculating the address of an array element by 
adding the array address, element index, with multiplication of element size^. 


So, the difference between MOV and LEA is that MOV forms a memory address 
and loads a value from memory or stores it there, but LEA just forms an address. 


But nevertheless, it is can be used for any other calculations. 


^See also: wikipedia 
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LEA is convenient because the computations performed by it does not alter 
CPU flags. This may be very important for OOE processors (to create less data 
dependencies). 


Aside from this, starting at least at Pentium, LEA instruction is executed in 1 


cycle. 
int f(int a, int b) 
1 
return a*8+b; 
}; 
Listing 1: Optimizing MSVC 2010 
_a$ = 8 ; size = 4 
_b$ = 12 ; size = 4 
_f PROC 
mov eax, DWORD PTR b$[esp-4] 
mov ecx, DWORD PTR _a$[esp-4] 
lea eax, DWORD PTR [eax+ecx*8] 
ret 0 
E: ENDP 


Intel C++ uses LEA even more: 


int fl(int a) 
1 
return a*13; 
p 
Listing 2: Intel C++ 2011 
fl PROC NEAR 
mov ecx, DWORD PTR [4+esp] ; ecx=a 
lea edx, DWORD PTR [ecx+ecx*8] ; edx = a*9 
lea eax, DWORD PTR [edx+ecx*4] ; eax = a*9 + a*4 = a*13 
ret 


These two instructions performs faster than one IMUL. 


MOVSB/MOVSW/MOVSD/MOVSQ copy byte/ 16-bit word/ 32-bit word/ 64-bit word 
from the address which is in SI/ESI/RSI into the address which is in DI/EDI/RDI. 


Together with the REP prefix, it is to be repeated in a loop, the count is to be 
stored in the CX/ECX/RCX register: it works like memcpy() in C. If the block size 
is known to the compiler in the compile stage, memcpy() is often inlined into a 
short code fragment using REP MOVSx, sometimes even as several instructions. 


The memcpy(EDI, ESI, 15) equivalent is: 


; copy 15 bytes from ESI to EDI 


CLD ; set direction to forward 
MOV ECX, 3 
REP MOVSD ; copy 12 bytes 
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MOVSW ; copy 2 more bytes 
MOVSB ; copy remaining byte 


( Supposedly, it works faster than copying 15 bytes using just one REP MOVSB). 
MOVSX load with sign extension see also: (1.23.1 on page 254) 
MOVZX load and clear all other bitsi see also: (1.23.1 on page 255) 


MOV load value. this instruction name is misnomer, resulting in some confusion 
(data is not moved but copied), in other architectures the same instructions is 
usually named "LOAD" and/or "STORE" or something like that. 


One important thing: if you set the low 16-bit part of a 32-bit register in 32-bit 
mode, the high 16 bits remains as they were. But if you modify the low 32- 
bit part of the register in 64-bit mode, the high 32 bits of the register will be 
cleared. 


Supposedly, it was done to simplify porting code to x86-64. 


MUL unsigned multiply. IMUL often used instead of MUL, read more about it: 11.1 
on page 1255. 


NEG negation: op — -op Same as NOT op / ADD op, 1. 


NOP NOP. Its opcode is 0x90, it is in fact the XCHG EAX, EAX idle instruction. This 
implies that x86 does not have a dedicated NOP instruction (as in many RISC). 
This book has at least one listing where GDB shows NOP as 16-bit XCHG instruc- 
tion: 1.11.1 on page 63. 


More examples of such operations: (.1.7 on page 1313). 


NOP may be generated by the compiler for aligning labels on a 16-byte bound- 
ary. Another very popular usage of NOP is to replace manually (patch) some 
instruction like a conditional jump to NOP in order to disable its execution. 


NOT opl: opl = -opl. logical inversion Important feature—the instruction doesn't 
change flags. 


OR logical "or" 

POP get a value from the stack: value=SS: [ESP]; ESP=ESP+4 (or 8) 
PUSH push a value into the stack: ESP=ESP-4 (or 8); SS:[ESP]=value 
RET return from subroutine: POP tmp; JMP tmp. 


In fact, RET is an assembly language macro, in Windows and *NIX environment 
it is translated into RETN ("return near") or, in MS-DOS times, where the mem- 
ory was addressed differently (11.7 on page 1264), into RETF ("return far"). 


RET can have an operand. Then it works like this: 
POP tmp; ADD ESP op1; JMP tmp. RET with an operand usually ends func- 
tions in the stdcall calling convention, see also: 6.1.2 on page 932. 


SAHF copy bits from AH to CPU flags: 
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7 6 4 2 0 


SFZF AF PH [CR 


This instruction is often used in FPU-related code. 


SBB (subtraction with borrow) subtract values, decrement the result if the CF flag is 
set. SBB is often used for subtraction of large values, for example, to subtract 
two 64-bit values in 32-bit environment using two SUB and SBB instructions. 
For example: 


; work with 64-bit values: subtract val2 from vall. 

; .lo means lowest 32 bits, .hi means highest. 

SUB vall.lo, val2.lo 

SBB vall.hi, val2.hi ; use CF that was set or cleared at the previous 
instruction 


One more example: 1.34 on page 497. 


SCASB/SCASW/SCASD/SCASQ (M) compare byte/ 16-bit word/ 32-bit word/ 64-bit 
word that's stored in AX/EAX/RAX with a variable whose address is in DI/EDI/RDI. 
Set flags as CMP does. 


This instruction is often used with the REPNE prefix: continue to scan the buffer 
until a special value stored in AX/EAX/RAX is found. Hence "NE" in REPNE: 
continue to scan while the compared values are not equal and stop when equal. 


It is often used like the strlen() C standard function, to determine an ASCIIZ 
string's length: 


Example: 

lea edi, string 

mov ecx, OFFFFFFFFh ; scan 2?-1 bytes, i.e., almost infinitely 
xor eax, eax ; 0 is the terminator 

repne scasb 

add edi, OFFFFFFFFh ; correct it 


; now EDI points to the last character of the ASCIIZ string. 


; lets determine string length 


; current ECX = -1-strlen 
not ecx 
dec ecx 


; now ECX contain string length 


If we use a different AX/EAX/RAX value, the function acts like the memchr() 
standard C function, i.e., it finds a specific byte. 


SHL shift value left 
SHR shift value right: 
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These instructions are frequently used for multiplication and division by 2". An- 
other very frequent application is processing bit fields: 1.28 on page 382. 


SHRD opl, op2, op3: shift value in op2 right by op3 bits, taking bits from op1. 
Example: 1.34 on page 497. 


STOSB/STOSW/STOSD/STOSQ store byte/ 16-bit word/ 32-bit word/ 64-bit word 
from AX/EAX/RAX into the address which is in DI/EDI/RDI. 


Together with the REP prefix, it is to be repeated in a loop, the counter is in the 
CX/ECX/RCX register: it works like memset() in C. If the block size is known 
to the compiler on compile stage, memset() is often inlined into a short code 
fragment using REP MOVSx, sometimes even as several instructions. 


memset(EDI, OxAA, 15) equivalent is: 


; store 15 OxAA bytes to EDI 

CLD ; set direction to forward 
MOV EAX, OAAAAAAAAh 

MOV ECX, 3 

REP STOSD ; write 12 bytes 

STOSW ; write 2 more bytes 

STOSB ; write remaining byte 


( Supposedly, it works faster than storing 15 bytes using just one REP STOSB). 


SUB subtract values. A frequently occurring pattern is SUB reg, reg, which implies 
zeroing of reg. 


TEST same as AND but without saving the result, see also: 1.28 on page 382 


XOR op1, op2: XOR? values. opl = opleop2. A frequently occurring pattern is XOR 
reg, reg, which implies zeroing of reg. 


Less frequently used instructions 


BSF bit scan forward, see also: 1.36.2 on page 531 
BSR bit scan reverse 


BSWAP (byte swap), change value endianness. 


SeXclusive OR 
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BTC bit test and complement 
BTR bit test and reset 
BTS bit test and set 
BT bit test 
CBW/CWD/CWDE/CDQ/CDQE Sign-extend value: 
CBW convert byte in AL to word in AX 
CWD convert word in AX to doubleword in DX:AX 
CWDE convert word in AX to doubleword in EAX 
CDQ convert doubleword in EAX to quadword in EDX:EAX 
CDQE (x64) convert doubleword in EAX to quadword in RAX 


These instructions consider the value's sign, extending it to high part of the 
newly constructed value. See also: 1.34.5 on page 508. 


Interestingly to know these instructions was initially named as SEX (Sign EX- 
tend), as Stephen P. Morse (one of Intel 8086 CPU designers) wrote in [Stephen 
P. Morse, The 8086 Primer, (1980)]°: 


The process of stretching numbers by extending the sign bit is 
called sign extension. The 8086 provides instructions (Fig. 3.29) 
to facilitate the task of sign extension. These instructions were 
initially named SEX (sign extend) but were later renamed to the 
more conservative CBW (convert byte to word) and CWD (convert 
word to double word). 


CLD clear DF flag. 

CLI (M) clear IF flag. 
CLC (M) clear CF flag 
CMC (M) toggle CF flag 


CMOVcc conditional MOV: load if the condition is true. The condition codes are the 
same as in the Jcc instructions (.1.6 on page 1298). 


CMPSB/CMPSW/CMPSD/CMPSQ (M) compare byte/ 16-bit word/ 32-bit word/ 64- 
bit word from the address which is in SI/ESI/RSI with the variable at the address 
stored in DI/EDI/RDI. Set flags as CMP does. 


Together with the REP prefix, it is to be repeated in a loop, the counter is stored 
in the CX/ECX/RCX register, the process will run until the ZF flag is zero (e.g., 
until the compared values are equal to each other, hence "E" in REPE). 


It works like memcmp() in C. 
Example from the Windows NT kernel (WRK v1.2): 


$Also available as https://archive.org/details/The8086Primer 
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Listing 3: base\ntos\rtl\i386\movemem.asm 


; ULONG 

; RtlCompareMemory ( 
; IN PVOID Sourcel, 
; IN PVOID Source2, 
; IN ULONG Length 
i) 


; Routine Description: 


; This function compares two blocks of memory and returns the number 
; of bytes that compared equal. 


; Arguments: 


; Sourcel (esp+4) - Supplies a pointer to the first block of memory to 
; compare. 


; Source2 (esp+8) - Supplies a pointer to the second block of memory to 
; compare. 


; Length (esp+12) - Supplies the Length, in bytes, of the memory to be 
; compared. 


; Return Value: 
; The number of bytes that compared equal is returned as the function 


; value. If all bytes compared equal, then the Length of the original 
; block of memory is returned. 


RcmSourcel equ [esp+12] 
RemSource2 equ [esp+16] 
RcmLength equ [esp+20] 


CODE_ALIGNMENT 
cPublicProc _RtlCompareMemory ,3 
cPublicFpo 3,0 


push esi ; save registers 

push edi ; 

cld ; clear direction 

mov esi,RcmSourcel ; (esi) -> first block to 
compare 

mov edi,RcmSource2 ; (edi) -» second block to 
compare 


; Compare dwords, if any. 
rcm10: mov ecx,RcmLength ; (ecx) = length in bytes 
shr ecx,2 A length in dwords 


[0] 
o 
x 

ll 
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jz rcm20 ; no dwords, try bytes 
repe cmpsd ; compare dwords 
jnz rcm40 ; mismatch, go find byte 


; Compare residual bytes, if any. 


, 


rcm20: mov ecx,RcmLength ; (ecx) = length in bytes 
and ecx,3 ; (ecx) = length mod 4 
jz rcm30 ; 0 odd bytes, go do dwords 
repe cmpsb ; compare odd bytes 
jnz rcm50 ; mismatch, go report how far we 
got 


; All bytes in the block match. 


, 


rcm30: mov eax,RcmLength ; set number of matching bytes 
pop edi ; restore registers 
pop esi ; 


StdRET _RtlCompareMemory 


; When we come to rcm40, esi (and edi) points to the dword after the 
; one which caused the mismatch. Back up 1 dword and find the byte. 
; Since we know the dword didn't match, we can assume one byte won't. 


rcm40: sub esi,4 ; back up 
sub edi,4 ; back up 
mov ecx,5 ; ensure that ecx doesn't count 
out 
repe cmpsb ; find mismatch byte 


; When we come to rcm50, esi points to the byte after the one that 
; did not match, which is TWO after the last byte that did match. 


, 


rcm50: dec esi ; back up 
sub esi,RcmSourcel ; compute bytes that matched 
mov eax,esi : 
pop edi ; restore registers 


pop esi ; 
StdRET — RtlCompareMemory 


StdENDP RtlCompareMemory 


N.B.: this function uses a 32-bit word comparison (CMPSD) if the block size is 
a multiple of 4, or per-byte comparison (CMPSB) otherwise. 


CPUID get information about the CPU's features. see also: (1.30.6 on page 463). 
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DIV unsigned division 
IDIV signed division 


INT (M): INT x is analogous to PUSHF; CALL dword ptr [x*4] in 16-bit environ- 
ment. It was widely used in MS-DOS, functioning as a syscall vector. The 
registers AX/BX/CX/DX/SI/DI were filled with the arguments and then the flow 
jumped to the address in the Interrupt Vector Table (located at the beginning of 
the address space). It was popular because INT has a short opcode (2 bytes) 
and the program which needs some MS-DOS services is not bother to deter- 
mine the address of the service's entry point. The interrupt handler returns the 
control flow to caller using the IRET instruction. 


The most busy MS-DOS interrupt number was 0x21, serving a huge part of its 
API. See also: [Ralf Brown Ralf Brown's Interrupt List], for the most compre- 
hensive interrupt lists and other MS-DOS information. 


In the post-MS-DOS era, this instruction was still used as syscall both in Linux 
and Windows (6.3 on page 950), but was later replaced by the SYSENTER or 
SYSCALL instructions. 


INT 3 (M): this instruction is somewhat close to INT, it has its own 1-byte opcode 

(0xCC), and is actively used while debugging. Often, the debuggers just write 
the OxCC byte at the address of the breakpoint to be set, and when an exception 
is raised, the original byte is restored and the original instruction at this address 
is re-executed. 
As of Windows NT, an EXCEPTION BREAKPOINT exception is to be raised when 
the CPU executes this instruction. This debugging event may be intercepted 
and handled by a host debugger, if one is loaded. If it is not loaded, Windows 
offers to run one of the registered system debuggers. If MSVS? is installed, its 
debugger may be loaded and connected to the process. In order to protect 
from reverse engineering, a lot of anti-debugging methods check integrity of 
the loaded code. 


MSVC has compiler intrinsic for the instruction: — debugbreak()?. 


There is also a win32 function in kernel32.dll named DebugBreak ( )?, which also 
executes INT 3. 


IN (M) input data from port. The instruction usually can be seen in OS drivers or in 
old MS-DOS code, for example (8.8.3 on page 1078). 


IRET : wasused in the MS-DOS environment for returning from an interrupt handler 
after it was called by the INT instruction. Equivalent to POP tmp; POPF; JMP 
tmp. 


LOOP (M) decrement CX/ECX/RCX, jump if it is still not zero. 


LOOP instruction was often used in DOS-code which works with external devices. 
To add small delay, this was done: 


"Microsoft Visual Studio 
8MSDN 
9MSDN 
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MOV CX, nnnn 
LABEL: LOOP LABEL 


Drawback is obvious: length of delay depends on CPU speed. 


OUT (M) output data to port. The instruction usually can be seen in OS drivers or in 
old MS-DOS code, for example (8.8.3 on page 1078). 


POPA (M) restores values of (R|E)DI, (R[E)SI, (RJE)BP, (R[E)BX, (R[E)DX, (R|E)CX, 
(RJE)AX registers from the stack. 


POPCNT population count. Counts the number of 1 bits in the value. 
POPF restore flags from the stack (AKA EFLAGS register) 


PUSHA (M) pushes the values of the (RJE)AX, (R[E)CX, (RJE)DX, (R[E)BX, (R[E)BP, 
(RJE)SI, (R[E)DI registers to the stack. 


PUSHF push flags (AKA EFLAGS register) 
RCL (M) rotate left via CF flag: 


ROL/ROR (M) cyclic shift 
ROL: rotate left: 


ROR: rotate right: 
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Despite the fact that almost all CPUs have these instructions, there are no cor- 
responding operations in C/C++, so the compilers of these PLs usually do not 
generate these instructions. 


For the programmer’s convenience, at least MSVC has the pseudofunctions 
(compiler intrinsics) rotl() and _rotr()+°, which are translated by the compiler 
directly to these instructions. 


SAL Arithmetic shift left, synonymous to SHL 
SAR Arithmetic shift right 


Hence, the sign bit always stays at the place of the MSB. 


SETcc op: load 1 to operand (byte only) if the condition is true or zero otherwise. 
The condition codes are the same as in the Jcc instructions (.1.6 on page 1298). 


STC (M) set CF flag 


STD (M) set DF flag. This instruction is not generated by compilers and generally 
rare. For example, it can be found in the ntoskrnl.exe Windows kernel file, in 
the hand-written memory copy routines. 


STI (M) set IF flag 

SYSCALL (AMD) call syscall (6.3 on page 950) 

SYSENTER (Intel) call syscall (6.3 on page 950) 

UD2 (M) undefined instruction, raises exception. Used for testing. 
XCHG (M) exchange the values in the operands 


This instruction is rare: compilers don’t generate it, because starting at Pen- 
tium, XCHG with address in memory in operand executes as if it has LOCK 
prefix ([Michael Abrash, Graphics Programming Black Book, 1997chapter 19]). 
Perhaps, Intel engineers did so for compatibility with synchronizing primitives. 
Hence, XCHG starting at Pentium can be slow. On the other hand, XCHG was 
very popular in assembly language programmers. So if you see XCHG in code, 
it can be a sign that this piece of code is written manually. However, at least 
Borland Delphi compiler generates this instruction. 


FPU instructions 


-R suffix in the mnemonic usually implies that the operands are reversed, -P suffix 
implies that one element is popped from the stack after the instruction's execution, 
- PP suffix implies that two elements are popped. 


10MSDN 
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-P instructions are often useful when we do not need the value in the FPU stack to 
be present anymore after the operation. 


FABS replace value in ST(0) by absolute value in ST(0) 
FADD op: ST(0)=op+ST(0) 
FADD ST(0), ST(i): ST(0)=ST(0)+ST(i) 


FADDP ST(1)=ST(0)+ST(1); pop one element from the stack, i.e., the values in the 
stack are replaced by their sum 


FCHS ST(0)=-ST(0) 

FCOM compare ST(0) with ST(1) 

FCOM op: compare ST(0) with op 

FCOMP compare ST(0) with ST(1); pop one element from the stack 
FCOMPP compare ST(0) with ST(1); pop two elements from the stack 
FDIVR op: ST(0)=op/ST(0) 

FDIVR ST(i), ST(j): ST(i)=ST(j)/ST(i) 

FDIVRP op: ST(0)=0p/ST(0); pop one element from the stack 
FDIVRP ST(i), ST(j): ST(i)=ST(j)/ST(i); pop one element from the stack 
FDIV op: ST(0)=ST(0)/op 

FDIV ST(i), ST(j): ST(i) - ST(i)/ST(j) 


FDIVP ST(1)=ST(0)/ST(1); pop one element from the stack, i.e., the dividend and 
divisor values in the stack are replaced by quotient 


FILD op: convert integer and push it to the stack. 

FIST op: convert ST(0) to integer op 

FISTP op: convert ST(0) to integer op; pop one element from the stack 
FLD1 push 1 to stack 

FLDCW op: load FPU control word (.1.3 on page 1293) from 16-bit op. 
FLDZ push zero to stack 

FLD op: push op to the stack. 

FMUL op: ST(0)=ST(0)*op 

FMUL ST(i), ST(j): ST(i)=ST(i)*ST(j) 

FMULP op: ST(0)=ST(0)*op; pop one element from the stack 

FMULP ST(i), ST(j): ST(i)2ST(i)*ST(j); pop one element from the stack 
FSINCOS : tmp=ST(0); ST(1)=sin(tmp); ST(0)=cos(tmp) 

FSQRT : ST(0) = \/ST(0) 
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FSTCW op: store FPU control word (.1.3 on page 1293) into 16-bit op after checking 
for pending exceptions. 


FNSTCW op: store FPU control word (.1.3 on page 1293) into 16-bit op. 


FSTSW op: store FPU status word (.1.3 on page 1294) into 16-bit op after checking 
for pending exceptions. 


FNSTSW op: store FPU status word (.1.3 on page 1294) into 16-bit op. 
FST op: copy ST(0) to op 

FSTP op: copy ST(0) to op; pop one element from the stack 

FSUBR op: ST(0)=op-ST(0) 

FSUBR ST(0), ST(i): ST(0)=ST(i)-ST(0) 


FSUBRP ST(1)-ST(0)-ST(1); pop one element from the stack, i.e., the value in the 
stack is replaced by the difference 


FSUB op: ST(0)=ST(0)-op 
FSUB ST(0), ST(i): ST(0)=ST(0)-ST(i) 


FSUBP ST(1)=ST(1)-ST(0); pop one element from the stack, i.e., the value in the 
stack is replaced by the difference 


FUCOM ST(i): compare ST(0) and ST(i) 

FUCOM compare ST(0) and ST(1) 

FUCOMP compare ST(0) and ST(1); pop one element from stack. 
FUCOMPP compare ST(0) and ST(1); pop two elements from stack. 


The instructions perform just like FCOM, but an exception is raised only if one 
of the operands is SNaN, while QNaN numbers are processed smoothly. 


FXCH ST(i) exchange values in ST(0) and ST(i) 
FXCH exchange values in ST(0) and ST(1) 


Instructions having printable ASCII opcode 
(In 32-bit mode.) 


These can be suitable for shellcode construction. See also: 8.14.1 on page 1149. 


ASCII character | hexadecimal code | x86 instruction 
0 30 XOR 
1 31 XOR 
2 32 XOR 
3 33 XOR 
4 34 XOR 
5 35 XOR 
7 37 AAA 
8 38 CMP 
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w 
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u 75 JNE 
V 76 JBE 
Ww 77 JA 
x 78 JS 
y 79 JNS 
Z 7a JP 


Also: 


ASCII character | hexadecimal code | x86 instruction 


f 66 (in 32-bit mode) switch to 
16-bit operand size 
g 67 in 32-bit mode) switch to 


16-bit address size 


In summary: AAA, AAS, CMP, DEC, IMUL, INC, JA, JAE, JB, JBE, JE, JNE, JNO, JNS, JO, JP, 
JS, POP, POPA, PUSH, PUSHA, XOR. 


.1.7 npad 


It is an assembly language macro for aligning labels on a specific boundary. 


That’s often needed for the busy labels to where the control flow is often passed, e.g., 
loop body starts. So the CPU can load the data or code from the memory effectively, 
through the memory bus, cache lines, etc. 


Taken from listing.inc (MSVC): 


By the way, it is a curious example of the different NOP variations. All these instruc- 
tions have no effects whatsoever, but have a different size. 


Having a single idle instruction instead of couple of NOP-s, is accepted to be better 
for CPU performance. 


;; LISTING.INC 


;; This file contains assembler macros and is included by the files created 
;; with the -FA compiler switch to be assembled by MASM (Microsoft Macro 
;; Assembler). 


;; Copyright (c) 1993-2003, Microsoft Corporation. All rights reserved. 


;; non destructive nops 
npad macro size 
if size eq 1 
nop 
else 
if size eq 2 
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mov edi, edi 
else 
if size eq 3 
; lea ecx, [ecx+00] 
DB 8DH, 49H, 00H 
else 
if size eq 4 
; lea esp, [esp+00] 
DB 8DH, 64H, 24H, 00H 
else 
if size eq 5 
add eax, DWORD PTR 0 
else 
if size eq 6 
; lea ebx, [ebx+00000000] 
DB 8DH, 9BH, 00H, 00H, 00H, 00H 
else 
if size eq 7 
; lea esp, [esp+00000000] 
DB 8DH, OA4H, 24H, 00H, OOH, 00H, 00H 
else 
if size eq 8 
; jmp .+8; .npad 6 
DB OEBH, 06H, 8DH, 9BH, 00H, 00H, OOH, OOH 
else 
if size eq 9 
; jmp .+9; .npad 7 
DB OEBH, 07H, 8DH, OA4H, 24H, 00H, OOH, OOH, OOH 
else 
if size eq 10 
; jmp .+A; .npad 7; .npad 1 
DB OEBH, 08H, 8DH, OA4H, 24H, 00H, 00H, OOH, 00H, 90H 
else 
if size eq 11 
; jmp .+B; .npad 7; .npad 2 
DB OEBH, 09H, 8DH, OA4H, 24H, OOH, OOH, OOH, OOH, 8BH, OFFH 
else 
if size eq 12 
; jmp .+C; .npad 7; .npad 3 
DB OEBH, OAH, 8DH, 0A4H, 24H, OOH, OOH, OOH, OOH, 8DH, 49H, 00H 
else 
if size eq 13 
; jmp .+D; .npad 7; .npad 4 
DB OEBH, OBH, 8DH, OA4H, 24H, 00H, OOH, OOH, 00H, 8DH, 64H, 247 
V H, 00H 
else 
if size eq 14 
; jmp .+E; .npad 7; .npad 5 
DB OEBH, OCH, 8DH, 0A4H, 24H, 00H, OOH, OOH, OOH, 05H, 00H, 2 
S 00H, OOH, 00H 
else 
if size eq 15 
; jmp .+F; .npad 7; .npad 6 
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DB OEBH, ODH, 8DH, OA4H, 24H, 00H, OOH, 00H, OOH, 8DH, 9BH, 2 
« 00H, OOH, 00H, 00H 
else 
“out error: unsupported npad size 
.err 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endif 
endm 


.2 ARM 


.2.1 Terminology 


ARM was initially developed as 32-bit CPU, so that's why a word here, unlike x86, is 
32-bit. 


byte 8-bit. The DB assembly directive is used for defining variables and arrays of 
bytes. 


halfword 16-bit. DCW assembly directive —"—. 
word 32-bit. DCD assembly directive —"—. 
doubleword 64-bit. 

quadword 128-bit. 


2.2 Versions 


ARMv4: Thumb mode introduced. 


ARMv6: used in iPhone 1st gen., iPhone 3G (Samsung 32-bit RISC ARM 1176JZ(F)- 
S that supports Thumb-2) 


ARMv7: Thumb-2 was added (2003). was used in iPhone 3GS, iPhone 4, iPad 
1st gen. (ARM Cortex-A8), iPad 2 (Cortex-A9), iPad 3rd gen. 


ARMv7s: New instructions added. iPhone 5, iPhone 5c, iPad 4th gen. (Apple 
A6). 
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* ARMv8: 64-bit CPU, AKA ARM64 AKA AArch64. Was used in iPhone 5S, iPad 
Air (Apple A7). There is no Thumb mode in 64-bit mode, only ARM (4-byte 


instructions). 


.2.3 32-bit ARM (AArch32) 


General purpose registers 


* RO — function result is usually returned using RO 


e R1...R12 — GPRs 


* R13 — AKA SP (stack pointer) 
* R14 — AKA LR (link register) 
* R15 — AKA PC (program counter) 


RO-R3 are also called "scratch registers": the function's arguments are usually passed 
in them, and the values in them are not required to be restored upon the function's 


exit. 


Current Program Status Register (CPSR) 


Bit 


Description 


0..4 


M — processor mode 


T — Thumb state 


F — FIQ disable 


| — IRQ disable 


A — imprecise data abort disable 


E — data endianness 


IT — if-then state 


16..19 


GE — greater-than-or-equal-to 


DNM — do not modify 


J — Java state 


Q — sticky overflow 


V — overflow 


C — carry/borrow/extend 


Z — zero bit 


N — negative/less than 


VFP (floating point) and NEON registers 


0..31P/5 | 32..64 | 65..96 | 97..127 
Q0138 bits 
D064 bits D1 
S032 bits | 51 S2 $3 


S-registers are 32-bit, used for the storage of single precision numbers. 
D-registers are 64-bit ones, used for the storage of double precision numbers. 
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D- and S-registers share the same physical space in the CPU— it is possible to access 
a D-register via the S-registers (it is senseless though). 


Likewise, the NEON Q-registers are 128-bit ones and share the same physical space 
in the CPU with the other floating point registers. 


In VFP 32 S-registers are present: SO..S31. 


In VFPv2 there 16 D-registers are added, which in fact occupy the same space as 
S0..S31. 


In VFPv3 (NEON or “Advanced SIMD”) there are 16 more D-registers, DO..D31, but 
the D16..D31 registers are not sharing space with any other S-registers. 


In NEON or “Advanced SIMD” another 16 128-bit Q-registers were added, which share 
the same space as DO..D31. 


.2.4 64-bit ARM (AArch64) 


General purpose registers 


The 


number of registers has been doubled since AArch32. 
X0 — function result is usually returned using XO 
X0...X7 — Function arguments are passed here. 

X8 


X9...X15 — are temporary registers, the callee function can use and not restore 
them. 


X16 

X17 

X18 

X19...X29 — callee function can use them, but must restore them upon exit. 
X29 — used as FP (at least GCC) 

X30 — "Procedure Link Register" AKA LR (link register). 


X31—register always contains zero AKA XZR or "Zero Register". It’s 32-bit part 
is called WZR. 


SP, not a general purpose register anymore. 


See also: [Procedure Call Standard for the ARM 64-bit Architecture (AArch64), (2013)]1. 


The 


32-bit part of each X-register is also accessible via W-registers (WO, W1, etc.). 


High 32-bit part | low 32-bit part 
X0 


WO 


llAlso available as http://infocenter.arm.com/help/topic/com.arm.doc.ihi0055b/IHI0055B 
aapcs64.pdf 
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2.5 Instructions 


There is a -S suffix for some instructions in ARM, indicating that the instruction sets 
the flags according to the result. Instructions which lacks this suffix are not modify 


flags. 


For example ADD unlike ADDS will add two numbers, but the flags will not be 


touched. Such instructions are convenient to use between CMP where the flags are 
set and, e.g. conditional jumps, where the flags are used. They are also better in 
terms of data dependency analysis (because less number of registers are modified 


during execution). 


Conditional codes table 


Code Description Flags 
EQ Equal Z==1 
NE Not equal Z==0 
CS AKA HS (Higher or Same) | Carry set / Unsigned, Greater than, equal C==1 
CC AKA LO (LOwer) Carry clear / Unsigned, Less than C==0 
MI Minus, negative / Less than N==1 
PL Plus, positive or zero / Greater than, equal N==0 
VS Overflow V ==1 
VC No overflow V == 0 
HI Unsigned higher / Greater than C == land 
Z==0 
LS Unsigned lower or same / Less than or equal C==00r 
Z==1 
GE Signed greater than or equal / Greater than or equal | N == V 
LT Signed less than / Less than N!=V 
GT Signed greater than / Greater than Z == 0 and 
N==V 
LE Signed less than or equal / Less than, equal Z==1lor 
N!2V 
None/ AL Always Any 
.3 MIPS 


.3.1 Registers 


( O32 calling convention ) 
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General purpose registers (GPR) 


Number Pseudoname | Description 
$0 $ZERO Always zero. Writing to this register is like NOP. 
$1 SAT Used as a temporary register 
for assembly macros and pseudo instructions. 
$2 ...$3 $VO ...$V1 Function result is returned here. 
$4 ...$7 $AO0 ...$A3 Function arguments. 
$8 ...$15 STO ...$T7 Used for temporary data. 
$16 ...$23 | $S0 ...$S7 Used for temporary data”. 
$24 ...$25 | $T8 ...$T9 Used for temporary data. 
$26 ...$27 | $KO ...$K1 Reserved for OS kernel. 
$28 $GP Global Pointer**. 
$29 $SP SP. 
$30 $FP FP*. 
$31 $RA RA. 
n/a PC PC. 
n/a HI high 32 bit of multiplication or division remainder***. 
n/a LO low 32 bit of multiplication and division remainder***. 


Floating-point registers 


Name Description 

$FO..$F1 Function result returned here. 
$F2..$F3 Not used. 

SFA..$F11 Used for temporary data. 
$F12..$F15 | First two function arguments. 
$F16..$F19 | Used for temporary data. 
$F20..$F31 | Used for temporary data". 


* — Callee must preserve the value. 
** — Callee must preserve the value (except in PIC code). 
*** — accessible using the MFHI and MFLO instructions. 


.3.2 Instructions 


There are 3 kinds of instructions: 


* R-type: those which have 3 registers. R-instruction usually have the following 


form: 


instruction destination, sourcel, source2 


One important thing to keep in mind is that when the first and second register 


are the same, IDA may show the instruction in its shorter form: 


instruction destination/sourcel, source2 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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That somewhat reminds us of the Intel syntax for x86 assembly language. 


* |-type: those which have 2 registers and a 16-bit immediate value. 
* J-type: jump/branch instructions, have 26 bits for encoding the offset. 


Jump instructions 


What is the difference between B-instructions (BEQ, B, etc.) and J- ones (JAL, JALR, 
etc.)? 


The B-instructions have an I-type, hence, the B-instructions' offset is encoded as a 
16-bit immediate. JR and JALR are R-type and jump to an absolute address specified 
in a register. J and JAL are J-type, hence the offset is encoded as a 26-bit immediate. 


In short, B-instructions can encode a condition (B is in fact pseudo instruction for BEQ 
$ZERO, $ZERO, LABEL), while J-instructions can't. 


.4 Some GCC library functions 


name meaning 

| divdi3 | signed division 

. moddi3 | getting remainder (modulo) of signed division 

. udivdi3 | unsigned division 

. umoddi3 | getting remainder (modulo) of unsigned division 


.5 Some MSVC library functions 


UL in function name stands for “long long", e.g., a 64-bit data type. 


name meaning 

| alldiv | signed division 

. alimut multiplication 

. allrem | remainder of signed division 

. allshl | shift left 

. allshr | signed shift right 

. aulldiv | unsigned division 

. aullrem | remainder of unsigned division 
. aullshr | unsigned shift right 


Multiplication and shift left procedures are the same for both signed and unsigned 
numbers, hence there is only one function for each operation here . 


The source code of these function can be found in the installed MSVS, in VC/crt/src/intel/*.asm. 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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.6 Cheatsheets 


.6.1 IDA 
Hot-keys cheatsheet: 


key meaning 

Space | switch listing and graph view 
convert to code 

convert to data 

convert to string 

convert to array 

undefine 

make offset of operand 
make decimal number 

make char 

make binary number 

make hexadecimal number 
rename identifier 

calculator 

jump to address 

: add comment 

Ctrl-X show references to the current function, label, variable 
(incl. in local stack) 


O AZOWXIOC*>D>UOO 


X show references to the function, label, variable, etc. 
Alt-| search for constant 

Ctrl-l search for the next occurrence of constant 

Alt-B search for byte sequence 

Ctrl-B search for the next occurrence of byte sequence 
Alt-T search for text (including instructions, etc.) 
Ctrl-T search for the next occurrence of text 

Alt-P edit current function 

Enter jump to function, variable, etc. 

Esc get back 

Num - | fold function or selected area 


Num + | unhide function or area 


Function/area folding may be useful for hiding function parts when you realize what 
they do. this is used in myscript?? for hiding some often used patterns of inline code. 


.6.2 OllyDbg 
Hot-keys cheatsheet: 


hot-key | meaning 


F7 trace into 
F8 step over 
F9 run 


Ctrl-F2 restart 


12GitHub 
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.6.3 MSVC 


Some useful options which were used through this book. . 
option | meaning 
/O1 minimize space 
/ObO no inline expansion 
/Ox maximum optimizations 
/GS- disable security checks (buffer overflows) 
/Fa(file) | generate assembly listing 
[Zi enable debugging information 
[Zp(n) pack structs on n-byte boundary 
/MD produced executable will use MSVCR* .DLL 


Some information about MSVC versions: 5.1.1 on page 889. 


.6.4 GCC 
Some useful options which were used through this book. 
option meaning 
-Os code size optimization 
-03 maximum optimization 
-regparm= how many arguments are to be passed in registers 
-o file set name of output file 
-g produce debugging information in resulting executable 
-S generate assembly listing file 
-masm=intel | produce listing in Intel syntax 
-fno-inline do not inline functions 
.6.5 GDB 


Some of commands we used in this book: 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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option 


meaning 


break filename.c:number 
break function 
break *address 

b 

p variable 

run 

r 

cont 

[o 

bt 

set disassembly-flavor intel 
disas 

disas function 
disas function, +50 
disas $eip,+0x10 
disas/r 

info registers 

info float 

info locals 

X/W ... 

x/w $rdi 


x/10w ... 
X/S ... 

XJ ... 
x/10c ... 
x/b ... 

x/h ... 

xJ/g ... 
finish 
next 

step 

set step-mode on 
frame n 
info break 
del n 

set args ... 


set a breakpoint on line number in source code 
set a breakpoint on function 

set a breakpoint on address 

print value of variable 

run 


n 


continue execution 


n 


print stack 

set Intel syntax 

disassemble current function 
disassemble function 

disassemble portion 

disassemble with opcodes 

print all registers 

print FPU-registers 

dump local variables (if known) 
dump memory as 32-bit word 

dump memory as 32-bit word 

at address in RDI 

dump 10 memory words 

dump memory as string 

dump memory as code 

dump 10 characters 

dump bytes 

dump 16-bit halfwords 

dump giant (64-bit) words 

execute till the end of function 

next instruction (don't dive into functions) 
next instruction (dive into functions) 
do not use line number information while stepping 
Switch stack frame 

list of breakpoints 

delete breakpoint 

set command-line arguments 


If you noticed a typo, error or have any suggestions, do not hesitate to drop me a note: my 
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OS Operating SysIeli- uunc CELA AEA Ya Org qeu see xe» x Ree Een xix 
OOP Object-Oriented Programming .............. llle 683 
PL Programming Language .......... o... e... e. e... xvi 
PRNG Pseudorandom Number Generator .........o ooo... o... e... x 
ROM Read-Only Memory .......... aa et ee 105 
ALU Arithmetic Logic Unit . co siao emu maaa a aor 9 35 
PID Program/process ETT 1028 
LF Line Feed (10 or in’ in C/C++) oe ek oe ek dk eee Ea eee oO 659 
CR Carriage Return (13 or "Win C/C++) 2... . 0.0. ee ee 659 
LIFO Lastin Arst OUt C ta a ed RAR OR OEE A 40 
MSB Most Significant Bit -oa oco oc ocer lk RR 397 


LSB Least Significant Bit 


NSA National Security Agency. ....... llle 1006 
CPB Cipher Feedback. uo occu hes be eee Roe e ee Le ae ae ESRB 1092 
CSPRNG Cryptographically Secure Pseudorandom Number Generator...... 1093 
ABI Application Binary Interface .......... o... o... e... e... .. ... 21 
PC Program Counter. IP/EIP/RIP in x86/64. PC in ARM. ................ 25 
SP stack pointer. SP/ESP/RSP in x86/x64. SP in ARM. ................. 25 
KA Return Address. ss ee a a EUR Read a uo GE CAS 29 
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PE Portable Executable «issues SERA A hh x om x Re UE Rem E REA i 7 
DLL Dynamic-Link Library ............... sss 963 
LR Link Register. -rsrsrs sooo RR er ee EERE bi ee 9 
IDA Interactive Disassembler and Debugger developed by Hex-Rays ...... 8 
IAT Import Address Table «2... eee me eee 964 
INT import Name Table so o ca epee os ee ee ERR EE RR 964 
RVA Relative Virtual Address. ......... o... o... . .. e... mee... 963 
VA Virtual Bares. «suene E a AAA RR EUR dee 963 
OEP Original Entry Point: «i.c nsn me; RE m momo n Ree Ren 949 


MSVC Microsoft Visual C++ 


MSVS Microsoft Visual Studio ............ llle 1307 
ASLR Address Space Layout Randomization. ............ o... ... .. 772 
MFC Microsoft Foundation Classes ......... o... o... . e... . . e... 968 
TLS Thread Local Storage o o sace r senex; e Rom a Ron E a 351 
AKA Also KNOWN AS: eca a ee 40 
ERT C Runtime IBP osx sek a oa aeie s ee EE Se |o Red ce e 3o 9o Ee Ree 14 
CPU Central Processing UNIE : osse sk RR ERE REGE M RR SEE A xix 
GPU Graphics Processing Unit... .... aaa 1105 
FPU Floating-Point Unit 22s esc XR X kw ee Eos uo eS V 
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CISC Complex Instruction Set Computing .......... o... o... .. ... 26 
RISC Reduced Instruction Set Computing ........o.. o... oo... e... .. 3 
GUI Graphical User Interface..........o o... oo... e... 959 
RTTI Run-Time Type Information .........o o... o... e... 703 
BSS Block Started by Symbol wk kee a a Rx RR RE 33 
SIMD Single Instruction, Multiple Data ............. llle. 246 
BSOD Blue Screen of Death .............o ooo ooo... e... ....... 950 
DBMS Database Management Systems ...................... ss. xvi 
ISA Instruction Set Architecture. ........ o... ooo... . leen xi 
HPC High-Performance Computing ......... llle 648 
SEH Structured Exception Handling .............. e... e... e... 50 


ELF Executable and Linkable Format: Executable File format widely used in *NIX 


systems including LINUX ne ee emm km] e e n mm Rom Rees 103 
TIB Thread Information Block «2.2522; RE RR 351 
PIC Position Independent Code .........o o... o... e... e... 676 
MAN Nota Number: snos use baa aaa a a a A 1295 
NOP No Operation «nas eae hale eek a A 9 
BEQ (PowerPC, ARM) Branch if Equal .............. eee ee es 122 
BNE (PowerPC, ARM) Branch if Not Equal... ........ llle 263 
BLR (PowerPC) Branch to Link Register .......... 0... o... ...... .. 1056 
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XDR exclusive OR. cocina xA ARR RE EORR a ee Re eS 1303 
MCU Microcontroller Unit ............ ooo... o... e... . .. .. .. 619 
RAM Random-Access Memory ...... 2l les 105 
GCC GNU Compiler Collection «sss mRREG RR RR ERR 5 
EGA Enhanced Graphics Adapter ...... llle 1265 
VGA Video Graphics Array . 2... ccelo rh Remy 1265 
API Application Programming Interface .........o.o. o... oo... e... .. 787 
ASCII American Standard Code for Information Interchange ............ 363 
ASCIIZ ASCII Zero (null-terminated ASCII string) ............... Ln 119 
IA64 Intel Architecture 64 (Itanium) ........... RR RR 573 
EPIC Explicitly Parallel Instruction Computing... ......... llle 1261 
OOE Out-of-Order Execution ......... l.l 575 
MSDN Microsoft Developer Network. .......... o... e. e... . e... .. 177 
STL (C++) Standard Template Library............. o... oo... ..... 712 
PODT (C++) Plain Old Data Type . ... cc ee um RR RR y 728 
HOD Hard Disk Drive: ic cg oa a m eme eon e RE BOR dog ed C RR e RR Re 744 


VM Virtual Memory 


WRK Windows Research Kernel ........... rh 911 


GPR General Purpose Registers .......... o... o... e... . ees 2 
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SSDT System Service Dispatch Table .............. 020002 95] 
RE Reverse Engineering . ......... o... e... meme 1284 
BCD Binary-Coded Decimal ................. e... e... a... 565 
BOM Byte Order Mark. 2: e ege xo ee a RR RR 897 
GDB GNU Debugger «<<. sro saranan GG Rx xk» EUER E Ra RR x RES 63 
Fe ie PARTE nouerat ud ack de dre Sh ee RD ee dece ien ek Reden 32 
MBR Master Boot Record ..........o.o o... «o... lees 905 
JPE Jump Parity Even (x86 instruction) .......... o... e... eee ee eee 298 
CIDR Classless Inter-Domain Routing ............. o... e... eee 605 


STMFD Store Multiple Full Descending (ARM instruction) 


LDMFD Load Multiple Full Descending (ARM instruction) 


STMED Store Multiple Empty Descending (ARM instruction) ............ 41 
LDMED Load Multiple Empty Descending (ARM instruction)............. 41 
STMFA Store Multiple Full Ascending (ARM instruction) ............... 41 
LDMFA Load Multiple Full Ascending (ARM instruction)................ 41 
STMEA Store Multiple Empty Ascending (ARM instruction) ............. 41 
LDMEA Load Multiple Empty Ascending (ARM instruction).............. 41 
APSR (ARM) Application Program Status Register ..............-..-.. 323 
FPSCR (ARM) Floating-Point Status and Control Register............... 323 
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RFC Request for Comments ia ao srd eaa na p m REA 903 
TOS TOR OT SIAC. ce bd auim d a a ee Ae Oe a ee eed 838 
LVA (Java) Local Variable Array ............. es 846 
JVM Java Virtual Machine .......... lees x 
JIT Just-In-Time compilation .............. sees 836 
CDFS Compact Disc Hle System ...... eee 919 


CD Compact Disc 


ADC Analog-to-Digital Converter .......... oo... e... .. . . ee 915 
EGP End ot RIG: a asig e iae eed a E a e ee 111 
DIY Dò t Yourself | occ dede uk A A A XoR Pw X AS 781 
MMU Memory Management Unit .......... llle 769 
DES Data Encryption Standard ........o.o.o oo... e... e... uu... 566 
MIME Multipurpose Internet Mail Extensions ......... 0... o... o... .. 566 
DBI Dynamic Binary Instrumentation .......... o... e... e... e... .. 657 
XML Extensible Markup Language ......... ooo... e... 793 
JSON JavaScript Object Notation ......... o... o... . . . .. . . . . . . .. 793 
URL Uniform Resource Locator . 2s ee cee ve kee RR ERA E 5 
IV Initialization Vector «osos oio ERE Rm xii 
RSA Rivest Shamir Adleman ............. e... e... e... 1206 
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CPRNG Cryptographically secure PseudoRandom Number Generator ...... 1207 
GIB- GIDIDYIE "C" 1224 
CRC Cyclic redundancy check ........... llle 1246 
AES Advanced Encryption Standard .............. 00002 eee eee 1247 
GC Garbage Collector ... sss ee ee a a n 779 

IDE Integrated development environment ............. llle. 473 

HB Pest BDO Re o doge oy one eee e RC al aon eec ire ee d e 1278 
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Glossary 


anti-pattern Generally considered as bad practice. 43, 100, 573 
arithmetic mean a sum of all values divided by their count. 649 


atomic operation “arouos” stands for “indivisible” in Greek, so an atomic opera- 
tion is guaranteed not to be interrupted by other threads. 807, 1002 


basic block a group of instructions that do not have jump/branch instructions, and 
also don't have jumps inside the block from the outside. In IDA it looks just like 
as a list of instructions without empty lines. 875, 1264, 1266 


callee A function being called by another. 44, 61, 88, 112, 125, 128, 131, 531, 573, 
685, 821, 931, 933-935, 938, 939, 1318 


caller A function calling another. 8, 10, 11, 14, 39, 61, 112, 125, 126, 130, 139, 
198, 531, 585, 685, 931, 932, 934, 935, 939 


compiler intrinsic A function specific to a compiler which is not an usual library 
function. The compiler generates a specific machine code instead of a call to 
it. Often, it’s a pseudofunction for a specific CPU instruction. Read more: (11.4 
on page 1258). 1306 


CP/M Control Program for Microcomputers: a very basic disk OS used before MS- 
DOS. 1149 


decrement Decrease by 1. 25, 231, 232, 255, 555, 921, 1297, 1300, 1306 


dongle Dongle is a small piece of hardware connected to LPT printer port (in past) 
or to USB. 1054 


endianness Byte order. 29, 102, 432, 1302 
GiB Gibibyte: 2% or 1024 mebibytes or 1073741824 bytes. 21 


heap usually, a big chunk of memory provided by the OS so that applications can 
divide it by themselves as they wish. malloc()/free() work with the heap. 41, 
434, 706, 709, 710, 727, 729, 750, 751, 793, 961, 962 
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increment Increase by 1. 22, 26, 232, 236, 255, 261, 408, 411, 555, 1297 


integral data type usual numbers, but not a real ones. may be used for passing 
variables of boolean data type and enumerations. 290 


jump offset a part of the JMP or Jcc instruction's opcode, to be added to the ad- 
dress of the next instruction, and this is how the new PC is calculated. May be 
negative as well. 120, 166, 167, 1297 


kernel mode A restrictions-free CPU mode in which the OS kernel and drivers exe- 
cute. cf. user mode. 1327 


leaf function A function which does not call any other function. 38, 43 


link register (RISC) A register where the return address is usually stored. This 
makes it possible to call leaf functions without using the stack, i.e., faster. 43, 
1055, 1315, 1316 


loop unwinding It is when a compiler, instead of generating loop code for n it- 
erations, generates just » copies of the loop body, in order to get rid of the 
instructions for loop maintenance. 235 


name mangling used at least in C++, where the compiler needs to encode the 
name of class, method and argument types in one string, which will become 
the internal name of the function. You can read more about it here: 3.21.1 on 
page 683. 682, 888, 889 


NaN not a number: a special cases for floating point numbers, usually signaling 
about errors. 293, 315, 1263 


NEON AKA "Advanced SIMD"—SIMD from ARM. 1315, 1316 
NOP "no operation", idle instruction. 921 


NTAPI API available only in the Windows NT line. Largely not documented by Mi- 
crosoft. 1012 


padding Padding in English language means to stuff a pillow with something to give 
it a desired (bigger) form. In computer science, padding means to add more 
bytes to a block so it will have desired size, like 2” bytes.. 899, 900 


PDB (Win32) Debugging information file, usually just function names, but some- 
times also function arguments and local variables names. 888, 965, 1012, 
1014, 1020, 1021, 1126 


POKE BASIC language instruction for writing a byte at a specific address. 921 
product Multiplication result. 126, 281, 285, 514, 545, 1254, 1255 


quotient Division result. 273, 276, 279, 280, 285, 544, 620, 651 
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real number numbers which may contain a dot. this is float and double in C/C++. 
273 


register allocator The part of the compiler that assigns CPU registers to local vari- 
ables. 253, 384, 531 


reverse engineering act of understanding how the thing works, sometimes in or- 
der to clone it. iv, 1306 


security cookie A random value, different at each execution. You can read more 
about it here: 1.26.3 on page 348. 990 


stack frame A part of the stack that contains information specific to the current 
function: local variables, function arguments, RA, etc.. 89, 126, 595, 596, 990 


stack pointer A register pointing to a place in the stack. 13, 15, 26, 41, 47, 57, 71, 
73, 96, 128, 685, 821, 931, 933-935, 1290, 1298, 1315 


stdout standard output. 28, 48, 198 


tail call It is when the compiler (or interpreter) transforms the recursion (tail recur- 
sion) into an iteration for efficiency. 600 


thunk function Tiny function with a single role: call another function. 30, 56, 491, 
1055, 1067 


tracer My own simple debugging tool. You can read more about it here: 7.2.1 on 
page 1007. 237-239, 680, 775, 893, 907, 911, 984, 1048-1050, 1129, 1137, 
1142, 1143, 1146, 1162, 1255 


user mode A restricted CPU mode in which it all application software code is exe- 
cuted. cf. kernel mode. 1077, 1326 


Windows NT Windows NT, 2000, XP, Vista, 7, 8, 10. 361, 528, 820, 897, 950, 963, 
1001, 1152, 1306 


word data type fitting in GPR. In the computers older than PCs, the memory size 
was often measured in words rather than bytes.. 563, 565-568, 714, 794 


xoring often used in the English language, which implying applying the XOR opera- 
tion. 990, 1070, 1075 
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.NET, 971 
OxOBADFOOD, 99 
OxCCCCCCCC, 99 


Ada, 136 
AES, 1088 
Alpha AXP, 3 
AMD, 938 
Angband, 378 
Angry Birds, 323, 324 
Apollo Guidance Computer, 265 
ARM, 261, 926, 1054, 1314 
Addressing modes, 554 
ARM mode, 3 
ARM1, 568 
armel, 285 
armhf, 285 
Condition codes, 170 
D-registers, 284, 1315 
Data processing instructions, 623 
DCB, 26 
hard float, 285 
if-then block, 323 
Instructions 
ADC, 500 
ADD, 28, 135, 170, 240, 401, 416, 
623, 1316 
ADDAL, 170 
ADDCC, 219 
ADDS, 133, 500, 1316 
ADR, 25, 170 
ADRcc, 170, 171, 206, 207, 574 
ADRP/ADD pair, 32, 72, 107, 357, 
376, 558 
ANDcc, 672 
ASR, 420 
ASRS, 394, 623 
B, 71, 170, 172 
Bcc, 123, 124, 186 
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BCS, 172, 325 

BEQ, 122, 207 

BGE, 172 

BIC, 393, 394, 400, 422 

BL, 25, 27, 29, 30, 32, 171, 559 

BLcc, 171 

BLE, 172 

BLS, 172 

BLT, 240 

BLX, 29 

BNE, 172 

BX, 133, 221 

CMP, 122, 123, 170, 207, 219, 240, 
416, 1316 

CSEL, 183, 189, 191, 417 

EOR, 400 

FCMPE, 326 

FCSEL, 326 

FMOV, 557 

FMRS, 401 

IT, 192, 323, 352 

LDMccFD, 171 

LDMEA, 41 

LDMED, 41 

LDMFA, 41 

LDMFD, 26, 41, 171 

LDP, 33 

LDR, 74, 96, 105, 335, 356, 554 

LDRB, 457 

LDRB.W, 262 

LDRSB, 261 

LEA, 574 

LSL, 416, 420 

LSL.W, 416 

LSLR, 672 

LSLS, 336, 400, 672 

LSR, 420 

LSRS, 400 
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MADD, 133 

MLA, 132, 133 

MOV, 10, 26, 27, 416, 623 

MOVcc, 186, 191 

MOVK, 557 

MOVT, 28, 623 

MOVT.W, 29 

MOVW, 29 

MUL, 135 

MULS, 133 

MVNS, 262 

NEG, 632 

ORR, 393 

POP, 25-27, 40, 43 

PUSH, 27, 40, 43 

RET, 33 

RSB, 178, 370, 416, 632 

SBC, 500 

SMMUL, 623 

STMEA, 41 

STMED, 41 

STMFA, 41, 75 

STMFD, 25, 41 

STMIA, 73 

STMIB, 75 

STP, 31, 72 

STR, 73, 335 

SUB, 73, 370, 416 

SUBcc, 672 

SUBEQ, 263 

SUBS, 500 

SXTB, 457 

SXTW, 376 

TEST, 253 

TST, 386, 416 

VADD, 285 

VDIV, 285 

VLDR, 284 

VMOV, 284, 322 

VMOVGT, 322 

VMRS, 322 

VMUL, 285 

XOR, 179, 401 
Leaf function, 43 
Mode switching, 133, 221 
mode switching, 29 
Optional operators 

ASR, 416, 623 

LSL, 335, 370, 416, 557 


LSR, 416, 623 
ROR, 416 
RRX, 416 
Pipeline, 219 
Registers 
APSR, 322 
FPSCR, 322 
Link Register, 25, 26, 43, 71, 221, 
1315 
RO, 137, 1314 
scratch registers, 262, 1315 
XO, 1316 
Z, 122, 1315 
S-registers, 284, 1315 
soft float, 285 
Thumb mode, 3, 172, 221 
Thumb-2 mode, 3, 221, 323, 324 
ARM64 
lo12, 72 
ASLR, 963 
AT&T syntax, 16, 49 
AWK, 909 


Base address, 962 
base32, 900 
Base64, 899 
base64, 903, 1084, 1207 
base64scanner, 900 
bash, 138 
BASIC 
POKE, 921 
BeagleBone, 1099 
binary grep, 907, 1004 
Binary Ninja, 1005 
Binary tree, 736 
BIND.EXE, 970 
BinNavi, 1005 
binutils, 476 
Binwalk, 1198 
Bitcoin, 802, 1099 
Boehm garbage collector, 778 
Boolector, 55 
Booth's multiplication algorithm, 272 
Borland C++, 766 
Borland C++Builder, 889 
Borland Delphi, 19, 889, 895, 1308 
BSoD, 949 
BSS, 964 
Buffer Overflow, 339, 346, 989 
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C language elements setjmp, 795 
C99, 140 srand(), 1047 
bool, 381 strcat(), 643 
restrict, 644 strcmp(), 571, 585, 634, 955 
variable length arrays, 352 strcpy(), 16, 637, 1083 
Comma, 1272 strlen(), 252, 526, 637, 660, 1301 
const, 12, 106, 581 strstr(), 584 
for, 232, 602 strtok, 266 
if, 156, 197 time(), 832, 1047 
Pointers, 87, 96, 141, 482, 530, 755 toupper(), 669 
Post-decrement, 554 va arg, 650 
Post-increment, 554 va list, 654 
Pre-decrement, 554 vprintf, 654 
Pre-increment, 554 write(), 789 
ptrdiff t, 779 C++,1131 
return, 13, 112, 139 C++11, 727, 943 
Short-circuit, 658, 662, 1272 exceptions, 978 
switch, 195, 197, 206 ostream, 702 
while, 252 References, 704 
C standard library RTTI, 702 
alloca(), 47, 352, 573, 978 STL, 887 
assert(), 360, 903 std::forward_list, 726 
atexit(), 713 std::list, 714 
atoi(), 624, 1113 std::map, 736 
close(), 955 std::set, 736 
exit(), 585 std::string, 705 
fread(), 789 std::vector, 727 
free(), 573, 751 C11, 943 
fwrite(), 789 Callbacks, 482 
getenv(), 1115 Canary, 347 
localtime(), 832 cdecl, 57, 931 
localtime_r(), 444 Cipher Feedback mode, 1091 
longjmp, 795 clusterization, 1204 
longjmp(), 198 COFF, 1064 
malloc(), 435, 573, 751 column-major order, 363 
memchr(), 1301 Compiler intrinsic, 48, 1254, 1257 
memcmp(), 571, 642, 905, 1303 Compiler’s anomalies, 185, 375, 394, 415, 
memcpy(), 16, 88, 639, 793, 1299 615, 666, 1257 
memmove(), 793 Core dump, 769 
memset(), 328, 638, 1142, 1302 Cray, 513, 568 
open(), 955 CRC32, 574, 600 
pow(), 287 CRT, 957, 985 
puts(), 28 CryptoMiniSat, 540 
qsort(), 482, 585 CryptoPP, 930, 1088 
rand(), 423, 892, 1018, 1020, 1047, Cygwin, 889, 893, 971, 1007 
1082 
read(), 789, 955 Data general Nova, 272 
realloc(), 573 De Morgan’s laws, 1274 
scanf(), 87 DEC Alpha, 511 
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DES, 513, 531 
dlopen(), 955 
disym(), 955 

dmalloc, 769 

Donald E. Knuth, 567 
DOSBox, 1152 
DosBox, 911 

double, 275, 938 
Doubly linked list, 714 
dtruss, 1006 

Duff's device, 616 
Dynamically loaded libraries, 29 


Edsger W. Dijkstra, 752 
EICAR, 1148 

ELF, 103 

Entropy, 1173, 1194 
Error messages, 902 


fastcall, 19, 45, 87, 383, 933 
fetchmail, 565 

FidoNet, 900 

FILETIME, 509 

FIXUP, 1051 

float, 275, 938 

Forth, 865 

FORTRAN, 31 

Fortran, 363, 644, 752, 889 
FreeBSD, 905 


Function epilogue, 39, 71, 74, 171, 457, 
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Function prologue, 14, 39, 43, 73, 347, 


910 
Fused multiply-add, 133 
Fuzzing, 633 


Garbage collector, 778, 866 
GCC, 888, 1319, 1321 


GDB, 38, 63, 67, 347, 492, 493, 1005, 
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GeolP, 1195 
GHex, 1004 
Glibc, 492, 794, 949 
Global variables, 100 
GNU Scientific Library, 449 
GnuPG, 1206 
GraphViz, 777 


grep usage, 239, 324, 887, 907, 911, 1128 


Hash functions, 574 


HASP, 905 

Heartbleed, 793, 1098 

Heisenbug, 802, 813 

Hex-Rays, 138, 249, 371, 377, 779, 811, 
1266 

Hiew, 119, 166, 195, 894, 901, 965, 967, 
971, 1004, 1255 

Honeywell 6070, 565 


ICQ, 921 
IDA, 113, 195, 476, 644, 880, 898, 1005, 
1232, 1319 

var ?, 73, 96 
IEEE 754, 274, 396, 473, 540, 1287 
Inline code, 241, 393, 633, 690, 732 
Integer overflow, 136 
Intel 

8080, 261 

8086, 261, 392, 1077 

Memory model, 830, 1263 

8253, 1151 

80286, 1077, 1264 

80386, 392, 1264 

80486, 274 

FPU, 274 
Intel 4004, 564 
Intel C++, 13, 514, 1257, 1264, 1299 
Intel syntax, 16, 24 
iPod/iPhone/iPad, 24 
Itanium, 511, 1260 


JAD, 6 

Java, 566, 835 

John Carmack, 657 
JPEG, 1203 
jumptable, 212, 221 


Keil, 24 
kernel panic, 949 
kernel space, 949 


LAPACK, 31 

LARGE INTEGER, 508 

LD PRELOAD, 954 

Linker, 105, 682 

Linux, 384, 951, 1131 
libc.so.6, 383, 491 

LISP, 760 

LLDB, 1005 

LLVM, 24 
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long double, 275 
Loop unwinding, 235 
LZMA, 1199 


Mac OS Classic, 1054 
Mac OS X, 1007 
Mathematica, 752, 1033 
MD5, 574, 904 
memfrob(), 1086 
Memoization, 1035 
MFC, 967, 1115 
Microsoft, 508 
Microsoft Word, 793 
MIDI, 905 

MinGW, 889, 1160 
minifloat, 557 


MIPS, 3, 915, 928, 964, 1054, 1202 


Branch delay slot, 11 
Global Pointer, 33, 370 
Instructions 

ADD, 136 

ADDIU, 34, 110, 111 

ADDU, 136 

AND, 395 

BCIF, 328 

BCIT, 328 

BEQ, 124, 174 

BLTZ, 179 

BNE, 174 

BNEZ, 223 

BREAK, 624 

C.LT.D, 328 

J, 8, 11, 35 

JAL, 137 

JALR, 34, 137 

JR, 210 

LB, 248 

LBU, 248 

LI, 560 


LUI, 34, 110, 111, 399, 560 
LW, 34, 97, 111, 210, 561 


MFHI, 136, 624, 1318 
MFLO, 136, 624, 1318 
MTC1, 479 

MULT, 136 

NOR, 265 

OR, 38 

ORI, 395, 560 

SB, 248 


SLL, 223, 268, 419 
SLLV, 419 

SLT, 174 

SLTIU, 223 

SLTU, 174, 176, 223 


SW, 81 
Load delay slot, 210 
O32, 81, 86, 87, 1317 
Pseudoinstructions 
B, 244 
BEQZ, 176 
LA, 37 
LI, 11 
MOVE, 35, 109 
NEGU, 179 
NOP, 38, 109 
NOT, 265 
Registers 
FCCR, 328 
HI, 624 
LO, 624 
MS-DOS, 19, 45, 350, 766, 825, 905, 911, 
921, 962, 1077, 1148, 1150, 1209, 
1263, 1287, 1300, 1305, 1306 
DOS extenders, 1264 
MSVC, 1319, 1320 
MSVCRT.DLL, 1160 


Name mangling, 682 
Native API, 963 
Non-a-numbers (NaNs), 315 
Notepad, 1200 


objdump, 476, 953, 971, 1005 

octet, 565 

OEP, 962, 971 

OllyDbg, 59, 91, 102, 126, 142, 160, 213, 
236, 256, 278, 294, 305, 332, 341, 
344, 364, 406, 432, 455, 456, 462, 
466, 486, 967, 1005, 1320 

OOP 

Polymorphism, 682 

opaque predicate, 677 

OpenMP, 802, 891 

OpenSSL, 793, 1098 

OpenWatcom, 889, 934 
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Oracle RDBMS, 13, 513, 902, 974, 1131, 
1141, 1143, 1223, 1236, 1257, 
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Page (memory), 528 
Pascal, 895 
PDP-11, 555 
PGP, 900 
Phrack, 900 
Pin, 656 
PNG, 1201 
position-independent code, 25, 951 
PowerPC, 3, 33, 1054 
Propagating Cipher Block Chaining, 1105 
Punched card, 329 
puts() instead of printf(), 28, 94, 138, 168 
Python, 656, 751 
ctypes, 942 


Qt, 19 
Quake, 657 
Quake Ill Arena, 482 


Racket, 1272 

rada.re, 17 

Radare, 1005 

radare2, 1205 

rafind2, 1004 

RAM, 105 

Raspberry Pi, 24 

ReactOS, 981 

Recursion, 40, 42, 599 
Tail recursion, 600 

Register allocation, 531 

Relocation, 29 

Resource Hacker, 1010 

Reverse Polish notation, 329 

RISC pipeline, 171 

ROM, 105, 106 

ROT13, 1086 

row-major order, 363 

RSA, 7 

RVA, 962 


SAP, 887, 1126 

Scheme, 1272 

SCO OpenServer, 1064 

Scratch space, 936 

Security cookie, 347, 989 
Security through obscurity, 903 


SHA1l, 574 
SHA512, 803 
Shadow space, 129, 131, 542 
Shellcode, 675, 950, 963, 1149, 1310 
Signed numbers, 158 
SIMD, 540, 642 
Software cracking, 18, 192, 774 
SQLite, 776 
SSE, 540 
SSE2, 540 
Stack, 40, 125, 198 
Stack frame, 89 
Stack overflow, 42 
stdcall, 931, 1255 
strace, 954, 1006 
strtoll(), 1103 
Stuxnet, 905 
Syntactic Sugar, 197 
syscall, 383, 949, 1006 
Sysinternals, 901, 1007 


Tagged pointers, 760 

TCP/IP, 572 

thiscall, 682, 685, 934 

Thumb-2 mode, 29 

thunk-functions, 30, 969, 1055, 1067 

TLS, 350, 943, 964, 971, 1291 

Callbacks, 947, 971 

Tor, 900 

tracer, 237, 488, 490, 893, 907, 911, 984, 
1005, 1088, 1129, 1137, 1142, 
1143, 1145, 1255 

Turbo C++, 766 


uClibc, 794 
UCS-2, 566 
UFS2, 905 
Unicode, 895 
UNIX 
chmod, 6 
diff, 922 
fork, 795 
getopt, 1103 
grep, 901, 1256 
mmap(), 766 
od, 1004 
strings, 900, 1004 
xxd, 1004, 1179 
Unrolled loop, 241, 352, 616, 620, 638 
uptime, 954 
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UPX, 1206 

USB, 1057 

UseNet, 900 

user space, 949 
user32.dll, 194 
UTF-16, 566 
UTF-16LE, 895, 897 


Windows 2000, 510 

Windows 98, 194 

Windows File Protection, 194 
Windows Research Kernel, 511 
Wine, 981 

Wolfram Mathematica, 1173 


UTF-8, 895, 1208 x86 
Uuencode, 1207 AVX, 513 
Uuencoding, 900 Flags 
CF, 46, 1296, 1297, 1300, 1303, 1307, 
VA, 962 1308 
Valgrind, 813 DF, 1303, 1308 
Variance, 1085 IF, 1303, 1308 
FPU, 1292 
Watcom, 889 Instructions 
win32 AAA, 1312 
FindResource(), 760 AAS, 1312 
GetOpenFileName, 265 ADC, 498, 826, 1296 
GetProcAddress(), 775 ADD, 13, 57, 126, 626, 826, 1297 
HINSTANCE, 776 ADDSD, 541 
HMODULE, 776 ADDSS, 554 
LoadLibrary(), 775 ADRcc, 181 
MAKEINTRESOURCE(), 760 AESDEC, 1088 
WinDbg, 1005 AESENC, 1088 
Windows, 1001 AESKEYGENASSIST, 1092 
API, 1287 AND, 14, 382, 387, 404, 421, 465, 
EnableMenultem, 1011 1297, 1302 
IAT, 962 BSF, 530, 1302 
INT, 962 BSR, 1302 
KERNEL32.DLL, 382 BSWAP, 572, 1302 
MSVCRS80.DLL, 484 BT, 1302 
NTAPI, 1012 BTC, 398, 1302 
ntoskrnl.exe, 1131 BTR, 398, 1002, 1302 
PDB, 887, 965, 1012, 1020, 1126 BTS, 398, 1302 
Structured Exception Handling, 50, 972 CALL, 13, 42, 924, 969, 1106, 1194, 
TIB, 350, 972, 1291 1297 
Win32, 381, 897, 954, 962, 1264 CBW, 1303 
GetProcAddress, 970 CDQ, 508, 1303 
LoadLibrary, 970 CDQE, 1303 
MulDiv(), 1032, 1255 CLC, 1303 
Ordinal, 967 CLD, 1303 
RaiseException(), 972 CLI, 1303 
SetUnhandledExceptionFilter(), 974 CMC, 1303 


Windows 2000, 964 
Windows 3.x, 820, 1264 
Windows NT4, 964 
Windows Vista, 962, 1012 


Windows XP, 964, 971, 1020 


CMOVcc, 171, 181, 183, 186, 191, 
574, 1303 

CMP, 112, 113, 585, 1297, 1312 

CMPSB, 905, 1303 

CMPSD, 1303 
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CMPSQ, 1303 
CMPSW, 1303 
COMISD, 550 

COMISS, 554 
CPUID, 462, 1305 
CWD, 826, 1157, 1303 
CWDE, 1303 

DEC, 255, 1297, 1312 
DIV, 1305 

DIVSD, 541, 909 
FABS, 1308 

FADD, 1308 
FADDP, 276, 283, 1308 
FATRET, 414, 415 
FCHS, 1309 

FCMOVcc, 318 
FCOM, 304, 315, 1309 
FCOMP, 291, 1309 
FCOMPP, 1309 


FDIV, 276, 907, 908, 1309 


FDIVP, 276, 1309 
FDIVR, 283, 1309 
FDIVRP, 1309 
FDUP, 865 

FILD, 1309 

FIST, 1309 

FISTP, 1309 

FLD, 288, 291, 1309 
FLD1, 1309 
FLDCW, 1309 
FLDZ, 1309 

FMUL, 276, 1309 
FMULP, 1309 
FNSTCW, 1309 
FNSTSW, 292, 316, 1309 
FSCALE, 479 
FSINCOS, 1309 
FSQRT, 1309 

FST, 1310 

FSTCW, 1309 
FSTP, 288, 1310 
FSTSW, 1309 
FSUB, 1310 
FSUBP, 1310 
FSUBR, 1310 
FSUBRP, 1310 
FUCOM, 315, 1310 
FUCOMI, 318 
FUCOMP, 1310 


FUCOMPP, 315, 1310 
FWAIT, 274 

FXCH, 1258, 1310 
IDIV, 620, 1305 


IMUL, 126, 374, 760, 1254, 1297, 
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IN, 924, 1077, 1151, 1306 
INC, 255, 1255, 1297, 1312 
INT, 45, 1149, 1305 
INT3, 893 
IRET, 1306 
JA, 158, 317, 1297, 1312 
JAE, 158, 1297, 1312 
JB, 158, 1297, 1312 
JBE, 158, 1297, 1312 
JC, 1297 
Jcc, 124, 185 
JCXZ, 1297 
JE, 197, 1297, 1312 
JECXZ, 1297 
JG, 158, 1297 
JGE, 157, 1297 
JL, 158, 1297 
JLE, 157, 1297 
JMP, 42, 55, 71, 969, 1255, 1297 
JNA, 1297 
JNAE, 1297 
JNB, 1297 
JNBE, 316, 1297 
JNC, 1297 
JNE, 112, 113, 157, 1297, 1312 
JNG, 1297 
JNGE, 1297 
JNL, 1297 
JNLE, 1297 
JNO, 1297, 1312 
JNS, 1297, 1312 
JNZ, 1297 
JO, 1297, 1312 
JP, 292, 1297, 1312 
JPO, 1297 
JRCXZ, 1297 
JS, 1297, 1312 
JZ, 122, 197, 1257, 1297 
LAHF, 1298 


LEA, 90, 129, 438, 587, 604, 626, 


937, 1016, 1106, 1298 
LEAVE, 15, 1298 
LES, 1083, 1156 
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LOCK, 1002 

LODSB, 1152 

LOOP, 231, 251, 910, 1157, 1306 

MAXSD, 550 

MOV, 10, 14, 16, 638, 639, 924, 966, 
1106, 1194, 1255, 1300 

MOVDQA, 517 

MOVDQU, 517 

MOVSB, 1299 

MOVSD, 548, 640, 1299 

MOVSDX, 548 

MOVSQ, 1299 

MOVSS, 554 

MOVSW, 1299 

MOVSX, 253, 261, 455, 457, 1299 

MOVSXD, 354 

MOVZX, 254, 435, 1055, 1299 

MUL, 760, 1254, 1300 

MULSD, 541 

NEG, 631, 1300 

NOP, 604, 1255, 1300, 1312 

NOT, 260, 262, 1300 

OR, 387, 660, 1300 

OUT, 924, 1077, 1306 

PADDD, 517 

PCMPEQB, 529 

PLMULHW, 513 

PLMULLD, 513 

PMOVMSKB, 529 

POP, 13, 40, 42, 1300, 1312 

POPA, 1307, 1312 

POPCNT, 1307 

POPF, 1151, 1307 

PUSH, 13, 14, 40, 42, 89, 924, 1106, 
1194, 1300, 1312 

PUSHA, 1307, 1312 

PUSHF, 1307 

PXOR, 529 

RCL, 910, 1307 

RCR, 1307 

RET, 8, 10, 14, 42, 347, 684, 821, 
1255, 1300 

ROL, 414, 1257, 1307 

ROR, 1257, 1307 

SAHF, 315, 1300 

SAL, 810, 1308 

SAR, 420, 648, 810, 1157, 1308 

SBB, 498, 1300 

SCASB, 1152, 1301 


SCASD, 1301 

SCASQ, 1301 

SCASW, 1301 

SET, 580 

SETcc, 174, 254, 316, 1308 

SHL, 267, 331, 420, 810, 1301 

SHR, 273, 420, 465, 810, 1301 

SHRD, 506, 1302 

STC, 1308 

STD, 1308 

STI, 1308 

STOSB, 619, 1302 

STOSD, 1302 

STOSQ, 639, 1302 

STOSW, 1302 

SUB, 14, 113, 197, 585, 626, 1297, 
1302 

SYSCALL, 1306, 1308 

SYSENTER, 950, 1306, 1308 

TEST, 253, 382, 386, 421, 1302 

UD2, 1308 

XADD, 1003 

XCHG, 1300, 1308 

XOR, 13, 112, 260, 648, 909, 1070, 
1255, 1302, 1312 


MMX, 512 
Prefixes 


LOCK, 1002, 1296 
REP, 1296, 1299, 1302 
REPE/REPNE, 1296 
REPNE, 1301 
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AF, 564 

AH, 1298, 1300 
CS, 1263 

DF, 794 

DR6, 1295 

DR7, 1295 

DS, 1263 

EAX, 112, 137 
EBP, 89, 126 
ECX, 682 

ES, 1156, 1263 
ESP, 57, 89 
Flags, 113, 160, 1291 
FS, 945 

GS, 349, 945, 949 
JMP, 217 

RIP, 953 
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SS, 1263 
ZF, 113, 382 
SSE, 513 
SSE2, 513 
x86-64, 19, 20, 66, 88, 94, 121, 128, 530, 
540, 925, 935, 953, 1287, 1294 
Xcode, 24 
XML, 900, 1084 
XOR, 1091 


Z80, 565 
zlib, 795, 1087 
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